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The intent of this software operational guide is to enable its 
user to successfully operate the Systems Communications Module 
CSYCCM) under control of the 81890/81790 Master Control Program 
CMHCP). AS a means to this objectives this document defines scope 
and objectives» describes inherent and command driven functionss 
and presents basic implementation characteristics. Addititonatly-s 
provides operating procedures at both system and terninal levels. 
(Terminal operating procedures are Limited to those capabilities 
Within the scope of SYCOM.) 


The Systems Communications Module can be used for a multitude of 
applications and by users with varying degrees of proficiency in 
computer operations. Although this guide has a tutoriat stante 
it does not claim to train ooerators. The reader is assumed to 
have a basic knowledge of the Bi8900/B1700 system and of the 
Master Control Program (MCP). The reader is also assumed to be 
familiar with BL8OO/B1700 operating proceduresse to have had 
experience cperating the system Supervisory Console (SPO) and 
peripheral devices» and to have a bastc vocabulary of comauter 
celated terms. The user need not howeverse need any knowledge of 
programming or of the Network Definition Language (NOL). 


This guide is designed to be self-contained. Howevers if the user 
wishes to have a deeper insiyht into the system's construction or 
precise details as to the various internal system functionse a 
reading of the "Network Definition Language Reference Manual" and 
the "System Software Unerational juide” is strongly recommended. 
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STRUCTURE OF THE DOCUMENT 
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Section I presents an overview of the Systens Comnunications 
Module atong with the functions tt performs. This section also 
identifies any limitations which aight be applicable to the 
usefulness of the system and Lists associated documentation. 


Section II describes concepts and imolementation characteristics 
employed ty the Systems Communications Module. This inctudes 
system configurationss functional specificationsre relationships 
in inter-system communications» and intracsystem relationships 
With other system software elements. Pictorial overviews are 
presented where applicable to etladorate noints of interest. 
Presentation of the Functional Description progresses from basic 
introductions» to what is tnvolved» thru detailed “how it works" 
explanations. 


Section III describes directive commands avaitable to the user 
from either a Work Station (terminal) or the User SPQ. With taese 
commands» the user directs SYCOM to perform specific functions to 
satisfy a user's processing requirements. Examoles are offered 
for each conmand which tncludes both command input and realy 
messages. The commands are presented in alohabeticalt order for 
ease of reference. The command tanguage construction is presented 
in details including keyword/parameter semantics. 


Section IV contains operating procedures for a SYCOM syst2a 
Coperating independently or in conjunction with the Supervisory: 
Message Control System (SMCS)? and for tltocatl system terminals. 
Under the heading "System Operating Procedures"s» useful SYCOM 
operating procedures» commands» and operational hints/pointers 
are presented. Under the heading *Terminat Operating Procedures". 
terminal operational commands and functions are covered which 
assume either a T0820 or [D830 Video Display Terminal (V)T). 
However» the system utilizes any surroughs supported VDT device. 


Section V presents instructions for the preparation of a Network 
Controtler program required by tha SYCOM system. It is basically 
comprised of a sample NDL coded input file for the Controller's 
generative procesSe Various commants are includ®d throughout the 
sample Listing to explain variable parameter data which could be 
different for each installation. The procedure used to invoke 
the generative process for an operational Network Controlier 
program tailored to the needs of individual systems is included. 
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Section VI contains appendices to this documente each of which is 
identified below: 


Appendix A provides tists of error messages and their meanings. 
These tists are broken down tnto two major categoriess those 
error messages which may be displayed tn response to commands 
and those error messages which are disotayed on the User SPO 
which identify a processing exception condition within SYCOM. 


Appendix B contains the “character set” defined for terainal 
input/output and data transmissions. 


Appendix C lists “reserved words" recognized by SYCOM» either 
as a command or cammand option keyword. 


Appendix D contains a “command summary" that lists each conmand 
and briefly describes its purpose. : 


Appendix E provides a list of all control messages used by the 
communications protocol and includes their associated format 
attributes. 


Appendix F presents a list of restricted MCP commands which are 
permitted from a terminal or SPO on the User Systen. 


Appendix G describes the PARAMETERS file attributes and details 
the parameters record format. 


Appendix H provides a summary of system filess including names 
and purposes. 


Appendix I contains sampte application programs which show the 
mechanics of interfacing with SYCOM and the system's terminals 
for vrogram=-to=progran and terminal=to-program communications. 
These sanple programs can also 3e utilized in the systen test 
procedures once the avpropriate Network Controtters are created 
and the systems installed. 


Section VII ts a glossary of terms and acronyms used: throughout 
this document. 
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+ Burroughs systems» this Software Operational Guide will + 
+ be updated to reftect those capability differences that ry 
+ are provided by 84800+ 84709» BEBO. and 86700 systems. + 
+ : + 
+ + 
+ + 
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SECTION I 
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INTRODUCTION TO SYCOM 
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SECTION I 


INTROOUCTION TO SYCOM 


GENERAL DESCRIPTION 
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The Systems Communications Module (SYCOM) program provides the 
BL800/817C09 user with 1) the capability to submit jobs to run on 
another systea- 2) to transfer files Between two systemSe and 3) 
in generals to interactively obtain services and information from 
another system with the ability to coamunicate with interactive 
programs in aremote system. Job run output can be returned to 
the submitting system Cupon request) or directed to a peripheral 
device on the processing system itself. Interactive output data 
is returned to the User System directlys via Network Controllers. 


SYCOM along with its associated Network Controller is responsible 
for all data communications with other systems. This includes 
performing the necessary functions to establish line connectionse 
recetve/transmit data» and executa the correct line ‘termination 
procedures. 


The Systems Communications Module maintains a secondary tLavel of 
control CCP has primary control) over local peripheral devices 
such as the card readere card punche Line printers and magnetic 
tapes. It reads and transfers cards taper and disk filese accents 
input from and displays messages to the Supervisory Console (SPO) 
and receives data files/messages for printings punchinge displaye 
or writing to either tape or disk. It orovides the mechanism by 
which a terminal or application orogram in one system is able to 
communicate with specific application programs tn another systen. 
Program selection 15 based on the Servicing system which dictates 
the processing requirements Cprograms) ootioned to run in that 
SyYSCCM%. 


SYCOM Saftware Operational Guide | | 30 Nov 1978 
Company Confidential ~--~= Santa 3arbara Plant Page = 6 


Section I Introduction to SYCGM CReviston "a™) 


SCOPE AND OBJECTIVES 
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The purpose of the Systems Communications Module is to inzrease 
the use of data processing facilities (systems) either tocat or 
remote to the target system. The scope of SYCOM is to provide 
alt of those features previously afforded by the Remote Job Entry 
CRJE/TERMINAL) system and additionally provide enhancements with 
the following expansive communications features: file transfer, 
terminal-to~programs program~torprograme and program-to-*SYCOM. 
The first two functions assume interwsystem communications with 
the program=to-SYCOM function assuming intra~system communication 
which is provided ty the MCP. The Systems Conmunications Module 
with these encompassing capabitities» considerably expands the 
flexibility of a RJE Stations henceforth referred. to as a "User 
System". 


In addition to the above design objectives» several mandatory 
objectives have been specified. They are: 1) Retain compatibility 
with the standard Burroughs d3ta communications Line discipline 
and message format conventions and 2) maintain standard Remote 
Job Entry (RJE) command compatibility witn existing RJE program 
products for S8urroughs small» medium» and large systems. 


With this software systeme the objectives are also to provide the 
user with the most benefits in terms of flexibility and ease of 
use. Flexibility tin that the user its free to design and install 
system configurations suited to the requirements of the company 
for distributed processing. For example» a user can tnstall a 
B1800/81700 in the same installation to tnerease/share resources 
with an existing systems tin a remote instatlation to place some 
resources in a remote facititys or in a network of systems to 
provide distributed processinjy services. Ease of use in that alt 
capabilities of the system can be selectivety utilized by any 
user thru either command initiated or inherent system functions. 


FUNCTIONS PERFORMED 
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Since SYCOM applications imply transmission of Large aata files 
between two or more systems» Line throughput maxisgizatione error 
detections and error recovery are standard features. Following 
is a comorehensive list of the functions oerformeds including 
those that are under user control. They are presented in three 
groupse Bastce Line Throughpute and Error Detection. and Recovery. 


SYCOM Software Operational Guide 30 Nov 1978 
Company Confidential ----- Santa S8arbara Plant Page - 7 


Section I Introduction to SYCOM (Revision "a"™) 


BASIC FEATURES 


For SYCOM to accomplish the functions generally described for the 
systems the following basic features are provideds full details 
are presented in Section II» "Concents and Facilities”. 


A» Input: Introduction of programs from an input device on 
the local svsten for compilation and/or execution on a 
remote system. Introduction of data from an input device 
on the tocal system for processing on the remote system. 


Be Command Input: SYCOM commands as well as SMCS/MCP type 
commands are permitted from the system SPQ» terminals, 
and specifically tailored application programs running 
in a system. 


Cs. Qutput: Dispersion of data and/or programs produced by 
the remote system to the tocal systems perinherat output 
devicese SPOr terminals» and application programs. 


De. Monitoring: Monitoring and controlling programs on the 
remote system via a local system's Remote Supervisory 
Console CPSC)? terminals SPO» or apoltication program 
Crequires SMCS on remote system). 


Eo File Control: SYCOM verifies all file transfers between 
two systems. 


F. File Transfers: Tho transfer of certain types of files 
between a local system and a remote systemr in both 
directions. 


Ge Program=to~Program: Supovort of communication between a 
program running in a local system and a program running 
in a remote system. Also» support a tocal application 
program communications Link to SYCOM itself. 


He. Virtuat Terminals: Provide a means by which a terminate 
SPU» or application program in a tocal system can become 
a virtual terminal entity to a remote systen. By designe 
Virtual terminals are automatically assigned the status 
of a Remote SPO when connected to a SMCS in the remote 
system. 


Ie Communications: Supports a full line of communications; 
asynchronous» synchronouse and direct connect. Line 
speed is dependent upon Line Adapter capabilities. 
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Section I Introduction to SYCOM (Revision a") 


LINE THROUGHPUT 


Maximization of Line throughnut is assured by a point-to-point 
message transfer procedure which: 


Ae. Specifically acknowledges receipt of a message with the 
transmission of either another message block or a 
"numbered acknowledgement ™ C#ACK) messagee This reduces 
both line time and tucnaround time. 


Be Blocks records for transnissions Ciee@es sends multiole 
data records per mnessage block. 


Ce Compress and expand blanks in data records. It is common 
for card input and printer output to have a Large number 
of iahedded blanks. Eliainating transmission of these 
blanks significantly improves tine throughput. 


ERROR DETECTION AND RECOVERY 


The following features are provided in error detection/recovary 
areas to assure reliable service to the system user: 


Ae A specific numbered acknowledgement Ceither tn the next 
messagea or in a #ACK) guards against the possibility of 
a lost message by providing an unambiguous acknowledge- 
ment for the transmitted message block. 


Bo The use of modulo 2 by the transmission numbering 
facility for the detection of duplicate nessage blocks. 


C. Oynamic reduction Cby command) of the transmission 
message block size provides the potential ror reducing 
error rates and retransmi SSions. 


D. The convention of different timeout values for local and 
remote systems alleviate Line cotttsiton problems. 


E. The message block transfer procedure eliminates the 
ambiguous use of certain ASCII control characters (for 
examples "ENQ" is used only during “estadlishment"?: and 
no where else). 


Fe Data transmission error detection is orovided thru the 
usc of vertical and horizontal parity in the systems 
hardware and software. 
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Section 1! Introduction to SYCOM (Revision “*a*™) 


LIMITATIONS 
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The Systems Communications Module (SYCOM) is intended to provide 
acombined system of RJE» file transfer» progran-to~SYCOM message 
transfer and terninat~to~program/proaram"to-program communication 
capabilities. To provide these services ana still maintain a 
certain degree of compatibility with existing Remote Job Entry 
C(RJE) systems» certain Limitations become inherent to the system. 
Therefores applicable limitations are defined as follows: 


Ae SYCOM does not» and wilt note» support Cassette tapes as 
an opttonal peripheral device. 


Be In reference to “file transfers» the implementation 
currently in effect does not saver or forwards symbolic 
file headers. Thereforer certain file characteristics 
would be lost on fite transfers hetween unlike systems. 


Ce. Program-to~Progjgram timitations involve an application 
program Geing assigned a “virtual terminal™* pasttion 
which reduces the nuaber of positions available for 
terminal attachments. 


De Interactive application programs in aremote system 
serving virtual terminals on a tocal system cannot make 
use of “tallies" or "toggles". This prevents CANDE from 
from being a viable application program in this system. 


Eo The implemented version of SYCOM which this document 
describes» does not have the "file transfer recovery" 
capability. Therefores when the occasion arises when an 
inter-system connection is toste any insprocess file 
transfer operations are aborted and must be restarted 
from the beginning. 


Fo The most noticeable limitation is the fact that SYCOM 
only supports a single line connection for RJE and File 
Transfer data communications> at any one time. 


NOTICE 


S aotnsaalicios icant an Ditranel 
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The specifications of the software system described in this 
document are subject to change without notice. The availanility 
or performance of some features may depend on a specific 
configuration of equipment sush as larger memory or communication 
line speed. Customers should consult their Burroughs Sates 
Representative for details. 
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Section I Introduction to SYCOM (Reviston "a™) 


ASSOCIATED DOCUMENTATION 
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Some of the details of the Systems Communicattons Module system 
and its composite software elements are contained in other: system 
manuals. Following is a list of associated documents referenced 
in this guide. Readers and users of this dacument may refer to 
any or all of these listed documents for additional information. 


Company Confidenttal 


Document Title . Identification Number 
B1800/B1700 SUPERVISORY MESSAGE CINTROL SYSTEM PeSe 2219 0482 
MESSAGE CONTROL SYSTEM INTERFACE | PeSe 2212 5447 
Bi700 NETWORK DEFINITION LANGUAGE . PeSe 2212 5223 
B1809/B1709 NOL LIBRARY PeSe 2212 5215 
B1700 DATA COMM AUDIT PeSe 2212 5421 


Corporate Released 


Document Title F Form Number 


BL800/B1700 SYSTEMS SYSTEM SOrTWARE 10668731 
OPERATIONAL GUIDE 

B1i700 SYSTEM NETWORK DEFINITION LANGUAGE CNDL) 1073715 
REFERENCE MANUAL 

B1700 SYSTEMS DATA COMMUNICATIONS 1089992 
INFORMATION MANUAL 

BURROUGHS CORPORATE DATA COMMUNICATIONS STANDARDS 1284 9006 
Bi8OO/B1700 SYSTceMS REMOTE JOB ENTRY CRJE)D © 1090602 


REFERENCE MANUAL 


Bl1BCO/B1i70G SUPERVISORY MESSAGE CONTROL SYSTEM Preliminary 
SOFTWARE QPERATIONAL GUIDE 


SECTION If 
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CONCEPTS AND FACILITIES 
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SECTION II 


CONCEPTS AND FACILITIES 
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GENERAL DESCRIPTION 
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eee ee ee ee ete me ee ee ee me ee ot 


To elaborate upon the design concepts apptied to SYCOMs the full 
range of system facilities are presented in logical progression. 
First to be covered are actual system hardware configurations. 
This provides the base for further conceot elaborations. Next»e 
descriptions of the data communication networks involved and the 
relationship of a User System to 3 Server System are identified. 
Following thisr implementation concents and functional aspects of 
the system are described. 


THE SYSTEM CONFIGURATION 


Ce ee a 


A User System oriented to SYCOM utilizes a hardware configuration 
Simitar to the one shown in Figure II-1 Cnext page). <A system is 
usually comprised of the following hardware elements: processors 
memory» SPO» diske plus standard communication controls/adapter se 
Optionatly it can be equipped with an assortment of peripherals 
as per a user's needs (Ce.gs» card readere card punchse disk packs» 
line printer» magnetic tapes» etce and terminals). 


The SYCOM program is responsible for managing availability and 
use of peripheral devices which are used for SYCOM functions. It 
atso controls ali input/outout op2aratians for those perionheral 
devices as well as transmitting and receiving data files. (Data 
file is a general term used here to encompass allt file types 
acceptable to SYCOM such as datar proyram source/objects printer 
backup» etce.) 
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With this hardware configurations “alt"™ SYCOM capabilities for a 
User System ar2 initiated thru tha system SPO. An “extended” User 
System Cconfiguration with local terminats) adds a new dimension 
to the SYCOM system in that it's capabilities are no longer 
confined to initiation from tne SPO but are now also available to 
Local terminals as well. Commands entered from a system SPO can 
initiate any SYCOM functions tncluding establish the connection 
for virtual terminal communications. Terminals are» howevers 
restricted to an explicit command repertoire. (Details of this 
concept are presented later in this section.) 
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Figure II~7i: User System Configuration 
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Section II Concenots and Facilities (Revision "a™) 


SYSTEM COMMUNICATIONS 


Described here are the communications network aspects of a User 
System and its relationship to a Server Systeme. SYCOH and its 
associated Network Controtler supports User Systens using either 
a point"to~point nonsswitched or point=to7point switched network 
to a Server System. 


The data communications procedure utilized is a subset of the 
Burroughs conversational pointtotooint line procedure. [It is 
defined in a document entitled “*Burroughs Corporate Data 
Communications Standards"s refer to “associated documentation". 
That document fully describes the characteristics and functional 
attributes for a nonttransoarent hatfrduptlex mode of data 


communication to which this systen subscrives. 


Point=to "Point Switched Network 


In a switched network environment» a User System communicates 
with a Server System without requiring dedicated tommunication 
Lines see Figure II-2 (on the following page). Yhe computers 
are cannected by telephone tines to the common carrier exchange 
serving their respective locations. <A temporary connection 
(date patn) is established between the computers only for the 
pertod of tine in which data transmission is actuatly required. 
The connection is established by ditating the telenhone number of 
the Server System. Usually the dialing procedure is manual, 
howevers SYCOH can cause this funstion to be done automatically 
upon command directive. 


In Switched line networks» a lina refers to a discrete data path 
between a Server System and the User System Cincluding terminals) 
theu the common carrier exchange. The services provided by this 
common carrier are usually on a time~used basis 
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Figure Il-2: Point-to-Point Switched Network 
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Section II Concepts and Facilities (Revision "a™) 


Point-to-Point Non-switched Network 


A point "to-potnt non-switched networks as shown in Figure I1-3 
(below)» consists of a private or leased communications tine that 
connects the User System with a Server Systen. In this network, 
the computers are physically connected» that tse the circuits 
making up the communications tine are permanently established» 
and data may be transmitted over the Line at any time. No dialing 
is required for this type of network. 


Communicatton lines tn a noneswitched network are alternatatly 
known aS privater leaseds» or dedicated Lines. In this document 
they are referred to as “dedicated tines". These tines may be 
privately owned Ceege» internal direct connection in the Same 
Pphysicat location)+ or provided by a common carrier on a contract 
basis. This dedicated connection between two specific locations 
would provide a tine for exclusiv2 system use. 
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Figure JI-3: Point=to7Poitnt Nonsswitched Network 
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Section [I Concepts and Facilities (Revision a") 


Communications Procedure 


With the conversationat potnt=to~point conmunications procedure 
assumed by SYCQMe inherent provisions include the capability to 
“reverse” message block transmissions without having to invoke 
seoarate establishment and termination procedures. The essential 
characteristic of this capability is its ability to specifically 
"acknowledge" receipt of the previous message block. This is 
accomolished by including a special acknowledgement character in 
the header of the “next” message olock transmitted. ‘This special 
character is the Acknowledge Received Messag? CARM) character. 


The usefulness of the ARM character is twofold: Firstr it) 
provides a specific acknowledgement to the recetot of a previous 
message block by utilizing the "numbered ACK" facility. Secondly» 
when the receiving system receives a message block that tt cannot 
accept (no buffer space or a specific perivheral is not-ready)- 
the ARM character pernits an implicit NAK of that message block. 
This is achteved by transmitting the NAK in the next outgoing 
message block. 


nated 


e 


bpp 


User System ~ Server System Relationship 


The concept of a User System = Server Systen relationship is 
quite fleetingr especially when both systems are in the same 
physical location.wj The important point to remembers howeverse 15 
the kasic principles of this relationshio Cdescribed belox) and 
how it applies to this system. j 


Referring to Figure II“4 Cfollowing page)» the User-System is 
viewed as the system tin the network which serves as a point of 
data collection and data distribution. For example» RJE type card 
inpute card outpute line printer outoute and/or terminal input/ 
output messages. : 


A Server System on the other hand is generatty considered to be 
the data processing system> often referred to as a Host System or 
Central System. It normatly recetves large volumes of data from 
a User System to be processed or drogram source files to pe 
compiled. In the case of’ program conpilationss the printout and/ 
or program object code files can xe transmitted back to tha User 
Systema Cupon request) for printing or possible program execution. 
Interactive output is returned directly to the initiating program 
or terminal via the Network Controtlters. 
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Figure II-4: User System - Server System Schematic 
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Section II Concepts and Facilities (Reviston "a") 


The actual physical size of a computer howevers has relatively 
Little importance when constdering a system as a Server Systen. 
The 861809/81700 system can be either a User or Server Systems 
depending on the angle of view and the services required at the 
time. It can also ber under certain circumstances» both a User 
System and a Server System. 
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The following list of equipment must be present for SYCOM system 
operations. Howeversr the tisted equioment 1s not dedicated to 
SYCOM €or supporting system software) and is available for use by 
other programs. 


Hardware Type 
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B1800/81700 Central Processor System Control 


98 KB Main Memory Cminimnum) System Software 


Secondary Memory Cdisk storage) 
. Chead-perwtracks pack) 


Program/Data Files AN 


\ 
120 or 132 Position Printer Line printer output — of 


80 or 96 Column Card Reader Control /2JE Type JTnput 


€0 or 96 Column Card Punch Controt/RJE Type Output 


System SPO 
Single or Multi Line Control 


Line Adapters as Required 
C(leasede Switched» direct) 


Data Sets and Cables 
{as required) 


TOB820/TDB30 Terminals 


MCP/SYCOM/SMCS Operations 
System/Terminal Coamunicattons 


System/Terminatl Communications 


System/Terminal Communications 


As Required 
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Section II Conceots and Facilities (Revision "a™) 


MEMORY REQUIREMENTS 


Provided here is a list of System Software elements and their 
associated memory requirements. They can be used to approximate 
memory requirements for an interactive B81800/81709 SYCOM systems 
operating with or without a Supervisory Message Control System: 


~ 64.9 KB Master Control Program (MCP). 

- 15.0 KB Network Controlter Cbasic). 

_ 3469 KB Each additionat line in the Controller. 

- 16.0 KB Supervisory Message Control System (SMCS). 

- 18.9 KB Systems Comaunications Module CSYCOM). 

~ 22.9 KB Command AND Edit system CCANDE).. 

- 2.9 KB Each additional terminal lLogged-on CANDE. 
After determining the basic memory requirements for the system» 
additional memory must be included for any other programs that 


are to be executed in conjunction with SYCOM. (S2e approdriate 
reference manuals for those memory requirement estimates.) 


In order for SYCOM to become operational» certain system software 
elements are required. Although these elements support the 
operation of SYCOM» they are general purpose and in fact support 
the entire system. Each software element identified here is 
individuatty documented for its capabtlittes and requirements. 
Following is a list of those pertinent system software elements: 


« Master Control Program (MCP) 


C* SYSTEM/MAKEUSER. progr:am 


ae 
ea 


« Network Controller program 
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Master Controt Program (MCP) 


The MCP is an operating system which manages the demands and 
resources of B16800/B1790 systems. [It reduces programming efforts 
by providing a family of commonly needed functions and services. 
The MCP requires strict user adherence to program structures and 
procedures in order that there may be communication between the 
different programs» interpret2arse and the MCP itself. 


Its primary function ts to optimize the productivity of a systen. 
External intervention is held to a minimums and maximum through- 
put is achieved by incorporating into the MCP the primary tasks 
of Input/Outout €1/0) control,» file handling» multtiprocessingr 
interrupts» memory allocations anplicatton programs» and ooerator 
interfaces. 


SYSTEM/MAKEUSER Program 


= aw ee ee OF ee eee oe ee oe oe ee ee a ee oe 


A utility program that is used to creater modifysr and access the 
system's “usercode" file. This file contains all valid system 
usercode/password combinations. These usercodes"passwords are 
maintained in a file named "CSYSTEMI/USERCODE™. With this file>» 
the MCP can supports and enforcer a file security mechanism for 
disk files and programs/users that access them. 


DMPALL Program 


The OMPALL program is a general naadia conversion facility that 
atlows reproduction of files Fron one medium to another. It also 
can list files from any nediua with bytes digit» or combined 
format. Along with these abilities it can start or stop its 
reading of these files at a specified record. Specifications for 
these functions may be passed to JMPALL from a SPU» Card Readerre 
or local system terminal. 


SYCOM Software Operational Guide 30 Nov 1978 
Company Confidential --<-"- Santa Jarbara Plant Page - 22 


Section I1 Concepts and Facilities CReviston a") 


Network Controller Prograa 


The Network Controller is a Network: Definttion Language (NDL) 
type program whose prime function 1s to process and supervise the 
flow of messages between systems» terminals» and programs. It 
performs all data communication line discipline functions which 
are necessary for proper Line/terminal control. The Network 
Controller handles the initiation and completion of cammunicattion 
I1/0"s and services exception conditions. In order to optimattly 
provide these functions» the Network Controller is configured» by 
NOL generation» to the soecific needs of the system on which it 
is to be runs (iwe@e» the number and tyne Lines» number and type 
terminals» etc.)- A product of this generative process is the 
Network Information File (NIF). fhis file contains all terminal 
and communication line attributes as well as Logical aspects of 
the communications network. 


Basically» this Controller enables messages to pass between it 
and SYCOM as welt as other terminal oriented programs ex2cuting 
in the system. This is accomplished via MCP supported Remote 
Files and Queue’s atong with the Jontrotter's message switching 
capability. Each program that is to be vart of the message flow 
must contain a "remote file" for input/output message traffic and 
it must be known to the Network Controllers this includes SYCUM. 


SOFTWARE OPTIONS 


The following software elements are not required but may be used 
in conjunction with SYCUM to service a particular user's needs. 


e Supervisory Message Control System (SMCS) 
« Application Programs 


e CANDE Program (Cmultiole-user text editing) 


Although the Supervisory Message Control System is not a required 
system software element for thre operation of a 3SYCOM systems it 
is definitely suggested for those systems which have terminals. A 
Terminal in a SYCOM system environment 15 permitted ta tnitiate 
"file transfers" or become a "virtual terminal” entity on a 
Server System. Addittonatty» these terminals may be utilized for 
other applicattons such as data entry and program devatonaent. To 
maintain averall control of the terminals tn these varied system 
environmentssr the SMCS becomes the controlling clement. . 
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Supervisory Message Control System (SMCS) 


The Supervisory Message Control System (SHCS) is tntended to be 
the "supervisor" for a data communications software system which 
includes such Burroughs software 2tements as “SYCOM™» CANDE» and 
other online programs of either Burroughs or customer origin. 


The SNCS provides to an interactive systems many functions and 
special features. To fully explore its capabilitiesr please 
consult the "SMCS Software Operationat Guide™. Howevers the 
highlights of some of the more pertinent functtons are presented 
here. Relevant to the SYCOM systeme SMCS provides sone basic 
message Switching (terminal to terminals terminal to SPO» and SPO 
to terminal)» attachnent of terminals to application programs via 
aremote filer and information about the system's network. 


Additionally» it controls terminal tlogron security (checking of 
user security codes and qranting access to user files) and 
approves Cor denies) all remote file opens to terminals under its 
control. Moreovers SMCS provides a certain degree of resource 
allocation. By this 15 meant» thru securityr job controle remote 
file control» and error handlinge the SMCS can altocate some of 
the systems resources. For exampler for every terminal controtled 
by the SMCSs it has final control over that device as a resource. 
It can thereforesr temporarily “attach” terminals to SYCOM by 
means of the SMCS “SIGN ON* facility. 


Application Programs 


Effectively there are three types of aoplicatton drograms useful 

to the SYCOM system users they are: 1) Interactive data entryre 

2) system~torsysteme and 3) command input to SYCOM. fFach prograa 
type is briefly described here with details of how they actually 

work presented in the following "Functional Description". 


A user can etect to develop an “interactive"™ application program 
tailored to Specific needs of an installatton. These specific 
Needs could include such applicattonat functions as data entryer 
information retrieval» or any application desired. 


If there is a requirement for an application program tin a User 
System to communicate directly with another applicatton program 
in a server Systems the capability 1s there. This communication 
link is directly thru the Network Controllers ani SYCO4M has no 
role in this message traffic. SYCOM does howevere initially 
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approve a “virtual terminal” (sn for tdentification and control 
purposes. This 18 a residual capability based on requirenents 
for Network Controilers by SYCOM. 


The third type of application orogran provides the source for a 
string of SYCUM commands to be performed on an automatic basis. 
Normatly this would be for off-hours operation but could also be 
utilized for common everyday occurrences of a work flow pattern. 


CANDE Prosram 


The B1800/81700 CANDE program provides generalized file updating 
and preparation capabilities in an interactives terminal oriented 
enviconment. CANDE performs these file updating and text editing 
functions in program devetopnent and other such environments. For 
this system howevere CANDE can only be utiltzed when SYCOM is not 
involved Ci.ee.» creation and naintenance of “NOL source” files.) 


The CANDE system has been designed to run in a self-sustaining 
operation or in conjunction with the SMCS. CIn either caseew it 
requires a Network Controlter for data communication functions.) 
It operates with a basic usercode-password type of security that 
is available to CANDE» and SMCS» from the MCP. 


FUNCTIONAL DESCRIPTION 


ee od 
an ee ee mee ee ee em eee ee eee ee 


The operation of SYCOM is deoendent upon support from a Network 
Controller program. This Network Controller provides interfacing 
Links between SYCOM and the communications hardware (terninals 
and other systems). The controllar furnishes those services and 
capabilities which are outlined in generat with the preceding 
subject» "Software Requirements". Throughout this descriptions 
Network Controller functions are elaborated upon where it is 
necessary to maintain continuity of subject matter. Concluding 
this sections functions of a Network Controller are outlined. 


Functional features of the system are described in the following 
order: Standard RJE» File Transferse Virtual Terminals» Program 
to-Program Comnunications and Network Control. Virtual terminals 
contributes Terminat“to-Programs Termtinalto"SYCOM and Renote 
Supervisory Console (RSC) communications.— 
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STANDARD RJE FUNCTIONS 


The SYCOM program controls» at a secondary tevel» all typical RJE 
peripheral devices of a User system. It reads and punches cards» 
prints outputs accepts SPO inputs displays SPO output nessages» 
and transfers file/control messagz2s between the User System and a 
Server System. 


Input can be directly from a card readers» from tape or disk thru 
file equates» or from the SPO. Card reader input is generally 
associated with RJE batch data transmissions? whereas magnetic 
tape and disk input more directly retates to file transfers. 
However» these operations in SYCOM are considered synonymous. 


Commands can be alternately itnput from a specifically designed 
application orogram thru the "Program-to~SYCOM” facitity. With 
this mechanisms the RJE input as well as associated output could 
be automatically controlled on a daily basis without requiring 
the system operator to enter a long series of commands to SYCOM. 


Qutput can be made directly to a card punch,» Line printer» disk> 
magnetic tape» or SPO. Howevers in the case of a printer or card 
punch» the data received can be in the form of a "backup file” 
which is first written to disk. Subsequent MCP commands are 
entered to cause printing or punching as appropriate. 


Furthermorey SYCOM gives certain directives to the Network 
Controller such as requesting it to establish or revwestablish a 
connection to a Server System. SYCOM also causes the controller 
to enter an “idte™ state while waiting for an incoming connection 
to be established and to terminate a connection when appropriate. 


The transmission of RJE data files to/from a Server System occurs 
as follows: <A user of the User System prepares a card deck for 
transmission to the Server System. The cards are read» compressed 
and blocked by SYCOQH Cupon command) and written into the Network 
Controller's remote fite.~ (See writeuon on “Queue Depth Control.) 
The controller begins tmmediately to transmit these card images 
C(messaqe blocks) to the Server System. This process continues . 
until all cards have been read and transmitted. The card file, 
known as a “job stream"s ts then under control of the Server 
System's MCP which processes that job stream as oar directives 
included in that file Ccompile and/or execute). 
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Atl SPO type messages which pertain to that job (30J»e EQS+ and 
SPO messages) are transmitted back to the User System for display 
on the User SPQ. wassages can be entered via the SPO to control 
jobs executin)j on the Server System: or manipulate data files as 
required? providing a MCS is running in that system. SYCOM 
accepts these messages and writes them to the Network Controlter 
for transmission to the Server System and subsequent processing. 


When the job has finisheds any associated tine printer and card 
punch output created at the Server System ts transmitted back to 
the User System. (CThis is dependent upon the software systen in 
the Server Systems HOST/RJIE does this automaticatly where SYCOM 
does not.) The Network Controller receives these incoming message 
blocks and forwards them to SYCOM via SYCOM*s remote file Cinput 
queue). SYCOM then appropriately prints and/or ounches this data 
on a User System oeripheral davic2. 


The afore described orocess describes the flow of data between 
the User System and a Server Systems often referred to as a "fob 
stream". Any number of job streams may be initiated at the same 
time (multiple Server System MCP directives contained in one job 
file) from a User System. The nuaber of jobs which can or will 
run on a Server System is timited only to its capabilities to 
process then. 


FILE TRANSFERS 


File transfers are supported.for both disk and magnetic tape 
devices. Files may be transferred between any combination of 
these devices. Magnetic tape transfers are restricted however, 
in that only one file per tape may be transferred. Library tapes 
created by the “LOAD.DOUMP™ function are not supported by SYCOM. 
(These tape files are first loaded to disk and then transferred.) 
Between “unlike™ systemse only program code files and 8=bit data 
files Cincludes text files) are oermitted. On the other hand- 
“"Like™ systens can transfer other files such as printer. backups 
punch backupr interpreters intrinsicer and dumo files. The data 
communications protocol allows transfer of onty one file at a 
tines in each direction. 


The user initiates a file transfer by entering a "COPY" comaand 
to SYCOM CPUT and FETCH are accentable alternates). The soamand 
syntax atlows source and destination systems to be specified 
(PUT and FETCH excluded) for the transfer via attributes. These 
source and destination system tdentifiers must be the same as 
those specified in the “"sSystam=id"™ control message at connection 
initialization time. 
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If the soecified source systen is the User System» the transfer 
is a “PUT"sS which is a transfer of a file “to” another system and 
is based on SYCOM's "“SYSTEMIDO" parameter. kKhen the sourc2 systen 
is a Server System,» then the transfer is a "FETCH"? which is the 
transfer of a file "from" another system» also based on SYCOM'S 
“SYSTEMID™ parameter. 


The actual transfer of a file is initiated by exchange of control 
information between syStemss this process is often referred to as 
“handshaking™". Atl file transfers occur as “Put's".° That ise if 
one system wishes to do a “"Fetch"™» it sends a “Fetch message” to 
the other system. This causes the other system to initiate a 
“Put" sequence by sending a "Put 4Yessage"™ to the initiating 
Systems. Put and Fetch messages completely specify both source 
_and destination file attributes. The Put message elicits a "Put 
Reply Message™» signifying that data transfer may begin. The 
sender system then sends one or more data message blocks which 
are eventually foltowed by an end-of-file message. 


Upon completion of the file transfer» the system that received 
tne file informs the originating system of the completion. This 
notification is nade with a “user-destined control message". 


If either system wishes to abort an in-process file transfer Cfor 
any reason)» that system sends etther an “*Abort Put™ or “Abort 
Fetch™ system control message to the other system. An abort is 
initiated by the appropriate command entered to SYCOM. Alternats 
"device not readys suspend” and “device readys resume” messages 
are used for flow control at any time for temporary stopoages. 


A file transfer reauest that cannot be processed uwuhen entered» 
because another file transfer ts tin progressr is queued to disk 
and processed when next possible. Although there is a maximum 
depth to this disk queue Csee "Restrictions™)» it is sufficient 
to handle alt but the most extreme cases. This feature orevents 
request rejections due to the fact that only one file transfer 
Cin each directton) can be intpoprocess ak any given time. Requests 
are queued on a ftrst comer first server basise This mechanism 
assures an orderly processing sequence. 


An tmportant potnt to noter all file transfer requests are queued 
as "Puts". This tse if a user requests a data file "Fetch"» that 
request is sent to the other system's SYCOM where tt iS queued as 
ae‘Put" on that system. 
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Maintaining Integrity of File Characteristics 


A goal of the file transfer mechanism is to maintain aS many of a 
file's characteristics as possible throughout the transfer. For 
exampler if a CO80L source progran is transferred» it should be 
capable of betng compiled,» without further modification» on the 
receiving system. Likewiser if a program code file is transferred 
to a “like system", it should be executable without modification. 


Specificallys if a file is transfarred between two like systems,» 

even if via one or more unlike systems» all file characteristics 

must be preserved.: To accomplish this» a symbotic version of the 
file's header Cunderstandablte to all systems) is transferred with 
the file. This symbolic file header is the "PUT“OR“FETCH*RECORD"™ 
as defined for SYCOM file transfers. It is prefixed in the data 

Stream by a beginning-oftheader control message. 


In the receiving systeme when a symbolic file header is received» 
as many as possible of the file characteristics are tncorporated 
into the file being created/received. If the file is transferred 
to an "unlike" system,r the symbolic file header and the original 
system type are saved with the file» to be forwarded with the 
file whenever it 15 again transferred. If the file is transferred 
to its original system typer the antire symbolic file header is 
incorporated to create a file identical in characteristics to the 
original file» and the symbolic header i5 not Saved. 


When a system sends one of its own filesr it must include in the 
symbolic file headere enough information for it to recreate that 
file if returned. If this file is returnede it must be made to 

look identical to the original file» with the exception of "file 
name" (this ts conveyed in the symbolic file header). 


An unlike system created file may be changed or reptaced tocallys 
thus invalidating the. saved symbolic file header. In this case,» 
the symoolic file header describes the file according to its new 
creation system type. 


NOTE GF IMPORTANCE: fhe “symbotic file header" discussed above 
is not implemented in this version of the system software. [t 
= Re) * “ 

will howevers be available in a later release of the system. 


9 
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VIRTUAL TERMINALS 


To the SYCOM system» a “virtual terminal” can be either a tocal 
terminal» the system SPOr or an application program. Thereforer 
virtual terminats is a Logical caoability whereby a messag2 vath 
can be established between a terminal» SPO» or program on the 
User System and an aopropriate interactive application progran 

in a Server System. Additionally» utilize the inherent capability 
of controtting jobs in a Server System with a special NCP command 
repertoire. pasicatty» on the Server System ends this becomes a 
reality thru the capabilities of the SMCS. Howevers the main 
inter-system connections are estanplished by SYCOM which makes it 
possible. Refer to Figure It-5 for a pictorial overview of a 
User System with virtual terminals. CInteractive anpoplication 
programs can be any program using a "remote file” but not using 
“"tallies™ or “toggles”™.) , 


The terminals are virtual in that all User System facilities as 
well as alt Server System facilities are available to the system 
user. User Systen commands are local and are thereforer processed 
within the User System by eitner SYCOMe SHCSe MCP» or application 
program. Server System input messages are accepted by the User 
System and transmitted to the Server System (via the Network 
Controtlers) for processing and subsequent rently messages. 


In view of a “virtual terminal™ in an interactive environanents 
Server System commands must be forwarded as soon as possible. To 
effect this requirement» SYCOWM has the capability to "interleave" 
a “user destined control message" into the data transmission 
Stream immediately if a file transfer is tn progresse If SYCOM 
is not presently transmitting a file» the controt messag2 which 
contains the virtual terminat message is tmmediately transmitted 
on an individuat basis to the Server Systen. : 


Terminal=to~Program Communications 


mean aww eH HT WOMEN HB APO Be tesa BOO mmnw eee 


When SYCQOM is utilized in a tlarger system development or data 
entry environment Cwtth terminais)» then the User System depicted 
in Figure IIe*l1l is applicable. In that hardware/software 
configurations the comolete spectrum of SYCUM capabiltties are 
available ta the system user. To be more Specificer tn addition 
to the capabilities oreviousty idantifieds a terminal-to-progjgram 
capability is available to the terminal user. 
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In this environments SYCOM stitt sommunicates directly with the 
Network Controller for normal conaunications activity. However,» 
the SMCS maintains elementary control over SYCOM and control over 
a system's terminals. To ctarify this» the SMCS directly causes 
the execution of SYCOM when a terminal Cor RSC) “*signs-on” to 
SYCOM thru the SMCS. A terminal user can then direct comnands to 
SYCOM in the User System or the SMCS in either the User or Server 
System. Exactly which commands and how the directives ara given 
is covered in Section IVe "Terminal Operations". An important 
notes these capabilities are also available to the user who 
opticnatly elects not to utilize a SMCS tn the system. (Refer to 
Figures I[T1I"9 and II-10 for configuration overviews. ) 


With the introduction of the SMCS software element into a Systeme 
all of its commands» functions» and capabilities become available 
to the terminal user. (Refer to the "SMCS Software Operational 
Guide" for details and capabilities.) 


Before proceeding» it might be telpful to this discussion for the 
terms User System and Server System to again be clarified. A User 
System 1s the computer on which there are terminats/users wishing 
to engage in interactive computing sessions. The Server System is 
the computer that supplies those interactive services on a demand 
basis. (CkKefer to Figure [LI-4s back a bit.) 


The communications protocol assum2d by SYCOM supvorts User System 
terminals connected (logically) to an interactive apolication 
program on a Server System. Using this protocot minimizes the 
visibility of interfacing software elements so that to a usere it 
appears as though the terminal is connected directly to the 
application program. The terminat is then used as if it was 
focaily attached to that program (see "Message Path Asstgnmoants"™ 
further on in this section). 


Presently available interactive application orograms may be used 
or the user can optionally elect to develop a special application 
program for terminal and/or other program interaction. 


The method for conveying terminal data between two systems makes 
use of the “device address” field in the control nessage.e. This 
message specifies the terminal with which the message text is 
associtated.e The device address tan the context 1s termed "virtual 
address™*,r and 1s the name used by both User and Server Systeans to 
reference a particular terminat. This addressing scheme follows: 


As The device address 18 conprised af two characters? one 
upper case and one tower case alphabetic letter. 
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Be. The User System “transmits” a virtual terminal address 
as lower case/upper case tletterss When it “recaives™ a 
response message from the Server Systeme the terminal 
address letters are reverseds upper case/tlower case. 


C. The Server System “receives” a virtual terminal message 
with a device address of tower/upper case tetters (Cas 
transmitted by the User System). The virtual tarminal 
addressing scheme then requires the Server System to 
“reverse” these device address characters prior to 1ts 
transmission back to the User System. (These transmit/ 
receive device addresses are specified in the Network 
Controller's NOL generation processs “both™ systems. 


Do Assume that a USer Systema supports a connection for five 
terminals to a Server Systeme The User System refers to 
these terminals by virtual terminal Ctransmit) address; 


aA» bAs cAr dAe and eA 


The Secver System also refers to these same terminals ty 
victual terminal (transmit) addresss but» as the Server 
Systems role 1s reversed» its transmit address is also 
reversed. For examote: 


Aa» Abe Ace Ade and Ae 


The following events represent tha terminal-to-tprogram procedure 
implemented by SYCOM. These events portray an interactive session 
between a virtual terminal on a User System and an aoptication 
program on a Server System. 


the user system 


BMwmwamean mm a wee oe oe eet ee 


At initialization timer SYCOM issues a "remote file information” 
request to obtains from the Network Controllers the Logical 
Station Numbers Ctsn's) for the virtual terminals assigned to the 
system. These numbers are placed tnto a table which maps the 
actual “lsn" of each virtual terminat into a virtual "tsn* with 
which SYCOM can reference the corresponding virtual terminal. 


When a user wishes a connection to a Server System» a “.CONNZCT" 
cammand is entered to the User System's SYCOM. SYCUM finds the 
next" available entry in its “virtual tsn table" and transmits a 
"connect message” to the specified Server System. [This controt 
message contains a virtual terminal address. Upon recetot of tha 
"connect reply message"» SYCOM replies with the results. 
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During the life of a connections alt data messages entered from a 
virtual terminal are sent to the Server System for processing. 
CExctuded are any tocal SMCS commands whicn are prefixed with the 
assigned signal character.) [This is accomplished by doing a 
remote file write to the Controtl2r using the terminal's virtual 
terminal "tsn". In processing this messager the Controller maps 
the virtual terminal tsn into the assigned virtual terminal 
address (two characters). The message is then transmitted to the 
Server System» according to SYCOM protocols with the virtual 
terminal address. The terminal user can then "sign on™ to any 
application program that is supported tn the Server Systems 
providing the capabiltty ts inherent in the form of a MCS. 


Any incoming message to the Network Controttler from a SYCOM Line 
which contains a virtual terminal address Cesger "Aa™e TAL» etc) 
is sent to SYCOM. These messayjes are written into SYCOM's remote 
file CLINK) by the Controller witn a device address appropriate 
for the terminal. SYCOM upon reading the messager searches the 
virtual terminat address table for the actual system "tsn" for 
that terminal. SYCOM then puts the actual "tisn™ tnto the reply 
message and writes tt into the Network Controller's remote file 
(station queue) for distribution to the originating terminal. 


In the case where the virtual terminal is actuatly an apotication 
programe the reply message 18 sent to that orograsn via the queue 
mechanism for “program~to7~SYCOM" communications. 


When the user wishes to disconnect from the Server Systeme a 
“DISCONNECT” command is entered to tocal SYCOM which transmits a 
"disconnect message” to the Server Systems specifying the virtual 
terminal address to be disconnected. The termtnat is notified of 
this action and is then free to establish another connection or 
Work pattern as desired. (Virtual terminals are automatically 
disconnected when the system operator enters the ".E0J" command.) 


the Server system 


The Server System's Network Controller tntercepts “connect” and 
"disconnect" messages Cuntike atl other control massage which are 
routed to SYCOM). Qn receipt of a “connect message"» the Network 
Controtter verifies that the addressed virtual tarminal axistss 
checks to see if tt can support another connecticne and that some 
interactive auplication oreogqram is ready to accept input from it. 
If atl is okayr the Network Controttler returns a "connect reply 
message” indicating successful completions atse the Controller 
sends back an error response in a “connect reply message". 
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When the connection is successful» the Server System makes this 
virtual terminal appear as a terminal local to that system. If 


the user 8 “lLoggeazon" to SYCOM- then that user is automatically 
“"Logged-on" to the Server System's SMCS. 


moe ia = 


During the Life of the cannection» any input data received by the 
Server System's Network Controller for an enabled virtual station 
is conveyed to the waiting application program thru its remote 
file Ccould be the SMCS). This message transfer transpires in 
exactly the same manner as for tlocal terminais. Any output data 
generated by that application program is transmitted back to the 
User Systems with the virtual terminal address specified. 


The Server System upon receiot of a “disconnect message™» takes 
necessary action to detach that virtual terminal and respond to 
the User System with an appropriate "disconnect reply message". 
If the user was togged-on to the Server Systen's SMCSe then tnat | 
user will be automatically “lLogged-off" the virtual terminal. i 


Remote Supervisory Console CRSC) 


aaa eme eae On Aan Swe Eh Mom Ho ea ow ee oF a AO et Oe oe ee on a8 


It is an inherent capability of the system to utilize the SPO» an 
application programs» or a terminal in a User System as a "Remote 
SPO" to a Server System. This only occurs whens as Figure II-6 
showsSe a copy of the SMCS iS running tn the Server System. For 
this system» the SPQ is also referred to as a “Remote Supervisory 
Console™» or simply the RSC. This term was selected to iaply. 
capabilities uhich transcend normal capabilities of a SPO. This 
interface infers communication (via the SNCS) with a Server 
System's MCPs hence the terme» Renote Supervisory Console. 


Messages input from the RSC to SYCOM are grouped tnto two basic 
typesr Locat SYCOM and Remote MCP. Local SYCOM input includes 
commands to initiate file transfers» request SYCOM status data» 
and other such functions. Additionallyr respond to conditions 
Within SYCO*¥t'sS domain that cannot be preprogrammed’ such as card 
reader not ready» clear pertpherals» etce. 


Remote MCP commands permitted from a RSC are basically directives 
used for control over the execution of jobs in the Server System? 
atl via the Server System*s SMCS. Only cartain MCP commands are 
permitted fron a KSC Creference Appendix Fe “Restricted MCP 

Command Summary") when the RSt'S "virtual terminal” assignment is | 
not declared as a Remote SPO in the Server System's Network i 
Controller? otherwiser onty Remote SPO restrictions apply. I 
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Figure J1I-6: RSC Input/Output Message Flow 
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Output messages for RSC display can be groupéd into four typess 


they are? Local SYCOH- Local 40P5 Remote SMCS» and Renote MCP. 


Local SYCOM outpur messages are normally responses to comnands 
but can also be error tyne messages reporting SYCOM problems. 
Locai MCP output would include suzth messages as "NO PRINTER 
AVAILABLE™ ang other such information messages which pertain to 
operations of a SYCOM syStem.e. Remote SMCS messages would he 
replies to SMCS commands entered for processing by the Server 
System's SMCS.j Remote MCP output nessages include SPO type outonut 
resulting from jobs run on a Server System. These messag25s are 
routed back to the User System's SYCOM program for display. 


In the case where the RSC is actually an application programe the 
response message 1S directed to that program via SYCOM*s "program 
to SYCOM™ queue mechanism. 


Referring again to Figure JI-6+ assume for examples that a user 
wanted to execute a job on the Server Systeme. ASSume also that 
the subject program and all data requirements reside in the 
Server System. The approprtate command string is entered to the 
User System's SYCOM>s via the SPO/RSC. SYCOM accepts this message 
from the MCP» formats and transmits tt to the Server Systams via 
the Network Controtler. (The command string could also be entered 
from either a tocal terminal or application programs Although 
these message paths are slightly differents the end results are 
the same.) 


In the Server System» the SHCS receives the MCP command message 


(from the Network Controtler) and “zips™ it along to the HCP. The - 


Server System's MCP orocesses the request as asked. Alt output 
messages pertaining to that job are qiven to the SMCS whith in 

turn initiates transmission to SYCOM in the User System. User 

SYCOM then displays these messages on its SPO/RSC. 


From this we can see SYCOM's tnvolvement and the processing flow 
involved in this type of operation. Atl preceding functions 
described for the RSC are over and atove the standard User SPQ 
input/output messages used for normal User System operations. 


Since SYCOM is Syametricals», both systems can perform an tdentical 
set of functions’ providing of courses both systems are of the 
Same seriese Actual input and output messages are exemplified in 
Section IV» “System Operating Procedures". 
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Program~to~SYCOmM Communication 


The same range of functions are possible for the Program-to-SYCOM 
facility as for Terminaleto=Program Communications. This feature 
is made possible by an adaptation of the Terminal<-to-Progjgram 
scheme. 


A mechanism Cof implementation dependent nature) 18 provided to 
allow an application program in the User System to masquer:ade as 
a “terminal"™. This application program must format messages to 
appear as if they were terminat keyboard input. These messages 
are then written into SYCOM*s "SYCOM/OUTO" queue for processing. 


From this point one at teast until a reply message is returned> 
processing for SYCOM is the sane as terminal~to-program commands. 
When SYCOM produces a reply wessager it writes the message into 
its "SYCOM/ING" queue file from where the application progran in 
turn ceads this gueue to obtain the message. These repty messages 
are formatted to terminal display specifications. Therefore» the 
application program can either printr store» tgnoree parse» or 
display select. message text as appropriate for the program. 


The schematic on the following page (Figure II-7) provides an 
overview of the mechanics for "Programmto-SYCGM Communications"; 
Communication between the applicatton program and SYCOM is thru 
the praviously identified pair of “queue files". The application 
program gives a command to SYCOH by writing into SYCOM*s input 
queue file named "SYCOM/QUTQ"™. The application program obtains a 
response message by reading from SYCOM*s "SYCOM/INQ" queue file. 


Message Formats used for “Proygram~to7SYCOM™ communications are 
defined in Section IVs “Appendix £%. No command restrictions are 
enforced for this method of SYCOM/system control. Howevers this 
feature is controlled by the SYCOQM parameter "PROGRAM" and for 
this function to be avaitlabler that parameter “must be” specified 
when the "SYCUM/PARAMETERS™ file is created. . 
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Figure JTI-7: Program-to-SYCOM schematic 
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PROGRAM-TO=PROGRAM COMMUNICATIONS 


The program-to-program capability emoloys an entirety different 
concept for inter "system communication. AS previously discussede 
this feature 1s an inherent by-product of the system. SYCOM 
itself is tin no way involved with the program-to-program message 
traffic and therefore» does not provide any Services to either 
program. The only exception to tnis is that SYCOM does “aoprove" 
a virtual terminal position for tne program communications pathe 


As shown in Figure II-8 (below)» communications are directly thru 
the Network Controllers via a speciat "remote file”™ declar:ed in 
each Controllers explicitly for that purpose. Both application 
programs must have mirror images of these remote files Cane each?) 
declared as welt. This remote file is shown tn bBoth Controller 
examples (Section V) as well as both sample application porograms 
(Appendix I). 


Figure II-8 can be used to visualize how an application program 
in one system can communicate witn a program in another systen. 
The input/output path is for the orogram to accept input messages 
from the Network Controller and return output reply messages for 
transmission to the other system/program.e. It would behove the 
developer of these application programs to design a specific set 
of messages which exclude any terminal connotations. This could 
greatly simplify development efforts extended for these drograas. 


The User System 
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Figure I1-8: Program-ta-Program Schematic 
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To convey certain required information» each input/output message 
must be orefixed with a “*header"™. The format of this Header is 
defined tin Section VIs "Appendix Er Message Formats". There are 
no restrictions as to the text in these messages but the Length 
is controlled with the parameter “BUFFER”. This parameter is in 
the "SYCOM/PARAMETERS*™ file and is specified at initialization. 


The usefulness of thts feature must be evatuated and decided upon 
by the system user. The capability is there to be utilizeds for 
whatever purpose. 


NETWORK CONTROL 


The SYCOM User System is normally considered to be the remote RJE 
Station and must initiate the transmission of data to the Server 
Systen. In a pointcto-point nonsswitched networks» this ts 
accomplished automatically by enabling the Line adapter and then 
exchanging handshaking control messages with the Server System. 


In a point-totpoint switched networks the User System must cail 
the Server System. This is accomplished by either dialrout 
Cautomatic dialing by the computer) or by manual dial-up (dialing 
performed by the system operator). The dialing is done “after” 
the adapter is enabled. When the Line connection ts established» 
the exchanging of handshaking control messages with the Server 
System 15 carried out. In a point-to-point nonswitched network 
utilizing a direct connections no dialing is dones or possible. 


Once this communication link has been established with a Server 
Systear line communication is identical for the switched and non- 
SWitched networks. (The User System and the Server System must 
be compatible as to transmisston rate and other such optional 
hardware capabilities.) 


Conversational Communication Procedure 


The following notes refer to the basic conversational Line 
discipline employed by SYCOM.. Thay apply to a point-tor~asoint 
Circuitr either dedicated or switched: 


_am am 4 
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Message Transfer: All message blocks are delineated oy special 
characters. Messages begin with a "SOH" character and end with 

a "BCC" character. The message control format is as follows: SOH> 
ARMs TM» STX» DAL» DA2» message text (blocked records)» ETX»s and 
finally the BCC. 


Retransmission of Messages: If the transmitting system does not 
receive a reply to its last transnisston within a given period of 
timer the unacknowledged message oslock 15 retransmitted. 


Parity or Block-Check Error Handling: If the receiving system 
receives a recognizable message» put it contains either a parity 
or block-check errorse it replies with a "NAK". The transmitting 
Systen should retransmit the messugee This 1$ reo3zated "n* nunber 
of times ("n" being user snecified)»e and if the error persists» 
either system can initiate error recavery. 


Message Idle State: If the receiving system receives a "good" 
message» but has no message traffic to send» it responds with an 
"ACK". If the sending system has more message trafficre it sends 
another message block. If the sending system has no aore message 
trafficr it proceeds to the “message idle state". 


Normat Termination: The normal termination of a conversation 
occurs when one system sends an "ACK" Cindicating that it has no 
more message traffic)» and the system receiving the "ACK" also 
has no more message traffic. The system receiving the "ACK" 
proceeds to the "message idle state”. 


Point-torPoint Contention Procedure 


Ce ee ee ee eee 2 ee ee ee ee ee 2 ee ee ee ee ed 


The essentiat characteristic of this procedure is that after the 
end-of-message transfer» as indicated by the transmission of the 
"OLE“EOT" sequencer both systems are in an tdtle state. Etther 
system may then bid for master status by sending the "DLE-ENQ®" 
sequencee This is normally initiated by the entry of a comnand 
to SYCOM. : 


Master Status: If either system is in the idle state and wishes 
to begin a message transfers it may bid for master status by 
sending the "“DLE“ENQ" sequence. If the same system had just 
terminated a message transfer by sending a "BLE-EQT" sequences 
then there is a delay created before this system again sends the 
"DLE"“ENQ" sequence. 
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Begin Message Transfer State: If the system bidding for amaster 
status receives an “ACK™ Cindicating ready to receive)» tt may 
commence message transfer immediately. If the response ts "NAK*" 
(not ready to receive)» the "JLE“ENQ" Sequence may be repeated up 
to a retry Limit of "na" C*n" being user specified)» and if no 
valid response is receivede commence error recovery. If the 
system bidding for master status receives the "“DLE°TENQ" sequence 
Cindicating that the other system is bidding at the same time)» 
it abandons its own bid and replies in accordance with its 
readiness to receive. In order to avoid any tine collistons when 
both systems are bidding at the same timer the nor~response timne= 
out values must be set to differeit values. This is true whether 
not the systems are “Like™ or “unlike”. 


Termination: The “DLE-EOT" sequence. is transmitted by the system 
directed to terminate to indicate the end of its sessione and if 
using a switched Lines to disconnect the moden. 


Transmission of Packed Oata 


As in previous versions of this protocols data records within a 
message block are separated Cy “RS" characters. Repeated 
occurrences of blank characters are compressed out using the 
"ESCrinteger™ mechanism. The method of representing non-printable 
characters has changed with SYCOM's imolementation. Printable 
characters are those tisted in “Appendix &B» Character Set™» with 
the exception of the “Line Feed™ and "BELL" characters. 


If the data records contain only orintable characterse than the 
first character of the record *1s not” a "DLE" character. If the 
data record contains any character not tn the “character sete 
then the first character of the racord must be a “OLE™ character» 
and the remainder of the record contatns transtated data. The 
originat Gata is translated such that every 4-bits is mazped into 
an 8ebit printable character. This mapping is accomplished by 
internal translations so that each 4-bits of data ts prefixed 
with a@ 4“bit hexadectmat value "4". CActual data transmissions 
occur in ASCII character mode. ) 
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NETWORK CCNTROLLER 


The Network Controller provides interfaces with the User System's 
terminals and Server Systems at the hardware tevel. It is 
responstble atl for direct communication with those terminals and 
Server Systems. It performs the actual data transmisston (both 
transmitting and receiving) functions between two systems. The 
Network Controtler accepts data messaye blocks and system controt 
messages from SYCOM and certain aoplication orograms (progran-to-~ 
program) and transmits them to the Server Systea. In reverseep it 
receives atl nessages from a Server System and forwards them as 
required for handling control and distribution. The SYCOM program 
relies upon the MCP for the basic function of "message queuing" 
between it and the Network Controtler and certain application 
orogramse. This facility provides the message paths between SYCOM> 
the SMCS» application orograms» and the Network Controtler. 


Following 1s a normat sequence of events which transpires between 
SYCOM» the Network Controtlers and the system's terminals: 


In response to a "poll" by the Network Controltiers a terminal 
transmits a message back to the Network Controtter. The Network 
Controller accepts the message and appends a headers supplying 
pertinent information about the messager Ceeger terminal typer 
isn» etc.). The Network Controller then determines which progran 
to send this message to and writas it into the appropriate 
proyram's remote fite Ctinput queue). CASSUMe tn this case tt is 
SYCOM.) SYCOM reads its remote file Cinput queue) and obtains 

an tnput message. Shoutd the message be a SYCOM commands it is 
processed and areply message created. The reply message 1s then 
Started down the Line by SYCOM when it writes the output message 
into tts remote file to the Network Controller. The Controttler 
in turn reads the reply message and transmits it (devotd of 
header of course) to the ortginating terminal. 


The description on the relationships of the SMCS and the Network 
Controller with SYCOMs which 1s also considered an application 
programe anoly to any apnltication program. Thuse any application 
program can enjoy the benefits of a sophisticated terminal 
network with message/terminal/progran management thru the SMCS 
and Network Controller. In summations the SMCS is the massage 
controller for the system. It also provides a myriad of functions 
which direct Network Controller functions as well as special 
purpose MCP functions. 
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CONFIGURATIONS AND SOFTWARE ASSOCIATIUNS 


The Systems Communications Module has been designed to operate in 
either of three modes> 1) as an individual entity "without™ local 
terminals» 2) as an individual entity» “with”" tocat terminals,» 
and 3) in conjunction with the Suoervisory Message Controt Systea 
CSMCS)s5 also with terminals. Referring to Figures JTI-9» IIL)» 
and IIeil (which follow)» system configurations with supporting 
software elements are Showns and described. 


Entry Level System 


am 2 we a ee as eee OP ee ee ee ee ee 


This system configuration provides alt of the SYCOM capabilities 
previously defined which includes the SP9 as a virtual terminal. 
This 18 accomplished with the smallest memory size commitment. 
Although the command repertoire is generally confined to entry 
from the system SPQ» special application programs running in the 
system can alternately inject comnands to SYCOM for processing. 


In the User System schematic which follows (Figure II-9)» the 
communication links between systen software elements are shown. 
Each of these Links» "“queues™ and “remote files"™» have snecific 
purposes which are briefly tdentified as follows: 


Ae “INQ"™ i5s a queue file us2d by SYCOM as output to an 


application program utilizing the "Program-to-SYCQM" 
facilities. 


Be FOUTQ" is also a queue file used by SYCQOM as _inout from 
an application program utilizing the "“"Progran~to-SYCOM"™ 
facilities. 


Co. “LINK* is a remote fite which is used in communications 
with a remote Server “host"™ System. ALL RJE and virtual 
terminal inout/output message traffic moves thru this 
file. This remote file is directly related to the SYCOM 
communications tine to a remote host. 


De "RFUSER" 1s a user defined name for a remote file used 
for program-to-porogram I/0 message traffice primarily 
directly thru the Network Controttlers. Atl nessages for 
this remote file move thru the Same comnunications line 
as those identified for the "LINK™ file. 
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/ 
/ 
f=] 
f/ Communications 
/ line to Server 
/ System. 


Figure II-9: User System Schematic 
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Section II Concepts and Facitities C(Reviston a") 
Extended Level System 


This system configuration also provides att SYCOM services as 
outlined for the Entry Level System and extends this to include 
local terminats. With terminals» SYCOM functions can te invoked 
from outside the computer room and away from the system SPO. 
Terminals on the system increase nemory usage in proportion to 
the number of terminals attached to the system and the line or 
tines for terminals. The mamory increase howeverr wilt be in the 
Network Controttler program and not SYCOM itself. 


Local terminals are exclusively owned and controtled by SYCOM. 
Although there is no operational SMCS required in a User System» 
it is “required™ in a 81800/81700 Server System when Remote SPO 
type activities are needed. The introduction of terminais in this 
system requires another remote file declared in both SYCO4 and 
the tocal Network Controller: 


Aw “TERMINALS* is the remote file used by SYCOM for Local 
terminal input/output message traffic between it and the 
Network Controtier. As the controller handles att 
necessary terminat interfacingr SYCOM onty reads tnout 
from and writes output to this remote file. 
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Section [II Concepts and Facilities (Revision "™a"™) 


° SPO/RSC 


/ 
B1800 or B1700 User System / 
; / 
a a ee me os um om ws ot ee on on ee ee ee ee ee aT ee st ee ee / Oe OP on ay Om A on ee GT em On me a we me oe one 
j ese @ew@eaeatveenseea4ueeanpwewvaenspeo@~ueanananneaeaea@nwpoaeneesanwngvgouenswuv eoaouevzseaenvpne/~e~NneCuaeenmo_ smn *# eae eaeceeoe#eeneeeo es @ t 
{ a , e@ 1 
i. Master Control Program (C(NMCP) . I 
{ . - | 
{ CRS ECKHE HS OH HEHHRHER SHEPHERDS HERHEHREHRHHD OHSS RES HHH OHH MOORE KR SCOR MH EHH BOD EO® ! 
| A A 1 
] { ee@eeaeevateee2nrvseds8 ae 8 @a2enee#er#e#se28e2@ 88 @ { { 
| { ° ° e ° | i 
i 1 e Program to . - Program to . i J 
{ I a SYCOM ° - Progran « ( { 
t ! | ° e e ° 1 1 
j | CINQ eoeaesete_ouepenee2e#es 8 4288 aevwvreoeee_ensveesneesds { 1 
] ] i 1 A V 1 
{ V t 1 1 ; eeee8seeeeskeneeeses#@ 1 
j ee w©exusen 8 @eaeaes { { ea e { 
{ . o<"(OUTQ)-=- mm-(RFUSER)~>. - | 
Ie o e Network ° i 
' - SYCQM cere ese See CTERMINAL S)eeces ewcenwn>. Controtter . f{ 
{ ® e 2 e | 
is o Sem mm em ern (LINK Dent terre emannnn>, e | 
1 aeeoaoee#8e6e#2%o## ©@ @#aeeees8s?8@e@ee#e8$ese« { 
ee eee ee eee 7 ww oe oe ow ee ee 2 ee ee t Meee / a 
/ / 
f ( 
/ por? 
/ / 
fans / 
/ / 
/ 
/ Communication 
eaetacenese line to Server 
° e System. 
e VDT's . 


ee¢econats#ev 


Figure [I-10: User System Schematic (terminals) 
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Section II Concepts and Faciltties C(Reviston "a"™) 


Uttimate Level Systen 


Using this configuration» not onty are all of the capabilities 
provided as outlined for both Entry Levelt and Extended Level 
systeass it now or-ovides the SYCO4 terminal user with an access 
to allt of the capabilities afforded by the Supervisory Message 
Controt System (SHCS). Memory increases in this configuration 
are directty related to the SHCS and the Network Controller. 


Local terminals in this system configuration are under direct 
control of the SMCS. Upon command (SMCS “Sign on™)» a terminal 
is temporarily "attached" to SYCOM for functional communications. 
When this SYCOM attachment is no Longer neededr the terminal its 
"detached" from SYCOM by entering “<smcs signal character> OFF"; 
This command 1s passed on to the SMCS by the Network Controtter 
which initiates the actuat detachnent and again assumes control 
of the terminal. As suche an additional terminal I/70 Link is 
needed. Also» tin addition to tnis links SYCOM's remote file 


"TERMINALS" is effected somewhat. Both are described as follows: 


Ae "MCSREMOTE" 18s a remote file used by the SMCS as a Link 
to the system's terminals. Ali terminal I/0 message 
traffic between SMCS and the Network Controller passes 
thru this file. During the time a terminal is “signed-~ 
on" to SYCOMs certain messages are “switched" to the 
SMCS for processing (those messages prefixed with a SMCS 
"signal character"). 


Be. “TERMINALS” is SYCOM'sS remote file for terminal input/ 
output massage traffic between it and the Controtler. 
The stight difference being that terminal input/outout 
only passes thru this fite for those terninals that are 
"signed"on™ to SYCOM. 
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(Revision *%*a"™) 


. SPO/RSC . 


eoeoenveeeewvwes 


B1800 or 81700 User System / 
/ 
aon ana anman m= on 0 an oe ee es Pt os an on mt we os eee ee ee eee ee ee / ke TS oe aa er ee ee 
{ Come Dem Oo eD Home SOMERS OEE OeR Eres ed EEeeseerenescnvrerenesece I 
1. « | 
i. Master Control ?rojram (HCP) - | 
H ‘eo e | 
H #e waobevweveee@weaseensenenmaaeenneesnsieieeekteaernreneeeeeoeu ea eaeweoanw#wmoamesaa eae Be weaeeaeesnemeneevewe#sees#s68eenee { 
i A A A i 
i | ! | J 
{ { eaeeeense#2eees ees ee@eeeneeeseaewevea Vv { | 
1 j a °° a a e@eee#se#¢ { | 
j | » Program . « Program . . e ] { 
i { alent aal” Bt to » * to . =ewn>. SMCS . ] ( 
i I { « SYCQM e « Program . ! ° e | i 
I | { @eoe#eee#e@2 84 8 aeosooeveenaae ] ~#eo 8@8@#08 8 @ | { 
i { t { A i | i 
{ § CINQ) i I C(HCSREMOTE) V i 
i } | j I { ea@@easeteeve#seeernbds#es { 
i Vv { | 1 “omen >, Pe | 
{ oe@envnve288086465 40 I | , s es j 
ee aS=COUUTQ)"" £9 858° CRFUSER Je---->, - i 
{ . e « Network Pe | 
! . SYCQM screenees CTERMINALS ) 333" oo== “~--->. Controtler .. | 
! « * = e i. . | 
a sores Sees CLINK J -4283s 7h 4e= <= laa ae | 
{ e@eoeeeeee#8#eets @saeeeveeoeno @#2nveeve eee @ t 
en oe te On ME nt On oe ot mm Se kk ee ee ee eee ee ee ee ee aa / =m me ow f aaa = 
/ / 
f / 
/ fas 
/ / 
| foe J f 
/ / 
/ 
Communication 
er ee line to Server 
e 7 e System. 
e VOT®s . 
Figure IIm11: User System Schematic (SMCSs terminals) 
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Section II Concepts and Facilities (Revision "a™) 


MESSAGE PATH ASSIGNMENTS 


In order to describe the potential message communication paths 
opened up by the virtual terminal capabilitys a special message 
path syntax was developed to pictorially present this myriad of 
posstbilities. The message path syntax is easy to understand as 
one can visualize these logical paths thru the User and Server 
Systeas. System software elements are easily recognized ay the 
widely used acronyms Call defined in the "Glossary™). Although 
the directional fiow arrows "“->" indicate a singte direction- 
communications are tworwaye Fhe 30xed tn syntactical elenents 
to the right indicate an alternata message paths atso availabte 
thru the “virtual terminal" capability. 


For the Entry Level System 


SPO input: 


Dn nardiprncetiitores Eiiemndiag cay aelivandiiendivansd 


8 ee ae OI ee en 


For an “Entry Level System™ (Figure TI-9) there are three message 
paths for SPO input. The following examples exptore each of these 
possibilities: 


User System 1 Server System 


se he ee et Oe OR OF 8 8 OS ae GE OE OD OE OH 8 EE Oe at SE FE EE OH OR OY OT OE OL OF an Or me 8 On SF §. OP ED oe on at me et On Oe oe 4S on OY a a) an oe ow We Mn oe oS 


@ew#eed@*exunvmeeceeseevenaneanmwonae veoeeoeoee @aeneeoeeseeense envwanne ve 


SPO: =e (CR ==> “SYCOM see NC Seer 
: / : 
: scene NC osae-> SYCOM 
; 1 
o<XXX> seee> SYCOM i | 
SKM: « See os Sates eer ese eee eee mee -SYCOM: Sess. S00 
i 


e oe 08 28 e8 


As shown in this diagrame all input command strings are given to 
User SYCOM by the MCP. Messages oreftxed with a period "." area 
processed by User SYCOM. - ALL othar Inout messages are sent to 
Server System's SYCOM which displays them an that SPO. When the 
"virtual terminal" capability is invoked (by using the ".CONNECT" 
command)» then the following message paths are established: 
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User System  { Server System 


mm Ca a a wm ee a a OS es a oe SE a Oe oD eo oP a a ee 2 ene nwmwan @Owm ae of we we oF woe mr awananwoeaae =~ =m oa ek om ee aon me wm 
‘ 
CONNECT <--> SYCOM ‘ 
t 
SPQ ==> MCP ==> SYCOM -e92> NC sere : 
: / : 
: | enes= NC so--> SMCS 


e@*@aeeaneawaeeseeesenvneesveeoese@e@eeoeoeeaeoeeVeeseeseenwesweeeoaneee es 


oSXXX> ee -> SYCOM I 
<KXX> Fan enw en nwaeananw ae erie ot roe os ee ee sue woman a > SMCS 
Z“XX> men me enn eee een ne eee > SMCS “==> MCP 
Z<nnn> ee Coleen) ee eee eee ge oe om se ee we oe a oe oe > SMCS aae> MCP 
. t 
lf_there_is_no_ SMCS _ currently _ running in _the Server System» then 


the message string is intercepted by the Network Controller which 
causes an error message to be displayad on that system's SPQ. 


Hhen a. SMCS_is_cunning_in_the Server System» the SPO operator can 
either “signton" to a program in that system or initiate RSC type 


commandss thru the SMCS. When the virtual terminal ts signed-on 
to the specified application programe it is "attached" to that 
program. All further nonwprefixed inout 15 sent to that program 
for processing. (CIn the example delows» the “£" character is 
assumed to be the Server System's SMCS “signal character", it 
could be another character.) 


User System i Server System 


ae eh Oe Oe a a et oO ot Ot ow es a on a anwar mm eam me eee oe ee me een we oF oe os ae oe ae aw a ae am mane & 8 a a cn a oh @ 
t 
SIGN ON AP «7~-> SYCOM 1 
t 


*aeoeo w@Gueaoaonev Bocuse eae e#enmoovnw ewe Ue ease aeoveoneae een 


SPO => MCP ==> SYCOM e2""> NC ween 


wmen~ NC =s9=> AP 
— NS> SMCS 


oes oOeeeneoeeaegpeece O@ee@wszepeausaea*a ose eeaeese Ra en anneeeownee 02 8 


oe eo ee & 6 
~ 
o> se as 68 8 


e<XXK> wee > SYCON { 


Kino Sees SE a RES See eet a Ses Saree. AP 
SEXKX> career anen ee eg ee So re Nee ee one ee Tne eee SMCS 
SI5kk> SSS ee Sore oe ere ee eyed ie oe eee % oOMCS. = FR> ACP 


$Z<nnn> were oa eee eee wenn > SMCS” -<-> MCP 
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Program=to~SYCOM input: 


a Ne lee De Rael el edlnctdnardll mall -apdliens Eteoedliandlt ee liaardl 


ae en a ee ee eS ee ee ee ee eee 


For “Program-to-=SYCOM4™ communicationss the following message path 
assignments are available: 


User system J Server System 


Sane a we i ee oe ot oe me ot we OP a OD we eo a a 8 ok me a wh ee ee ee oe aw | ee ee ee ee ee ee ee ee mano 


AP 0 eae eenenaen “> SYCOM =s9-> NC seHee : 
: / 
3 “sere oNt -ofee> SYCOM:, “s 


7 ae 

o<XXX> osee-> SYCOM l 
CXXK> 0 seen ee cmc nnnarenennanaue cwem=-> SYCOM ===> SPO 

| i 


ALL input command strings are given to User SYCOM by the MCP via 
the “QUTQ”" queue. Messages that are prefixed with a period "." 
are processed by User SYCOM. ALl other input messages are sent to 
Server System's SYCON which displays them on that SPQ. 


When the "virtual terminat™ capability ts invoked (by entry of a 
"CONNECT*™ command)+>+ the following messag? paths are established: 


User System I Server System 


oe ae @ ow A ee ae GU OM On OO Ee OE ee OP Oe a mE ae me MY Oe OF oe OP SS oy OD mo er oe am a ge on ae OE om os ae oe OT at Or ee Ot ae ot gH On oP GS as at we ae an on 
( 
eCONNECT ==> SYCOM ! 
l 
AP 0 teeene wenen-> SYCOM =""> NC ceeen : 
: / : 
to ee NC co-=> SMCS): 


e@eenseeaneneeerteaoeoevweanaeseseeecenweaesvpesenwereesewvrteeeneeeeeees 


o<XXX> eee => SYCOM ! 
CXKX> See mmm mean esa atid See ee es sae aaa eS ac Pe 
LEXX> = MSR Se Se SS Smee an we mawnn -=-> SMCS <--> MCP 


fc<nnn> es ee Le ORE OS EE 0 SO: OF RS a Oe ee oom mo wm > Sacs owe > HCP 
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If_there_is_no_ SMCS_ currently running in the Server System» then 
the message string is intercepted by the Network Controller which 
causes an error message to be displayed on that system's SPO. 


When _g_SMCS_is_ runniog_in_the Server system» this program can 
"sign-on" to a program in that system or initiate RSC commands; 
thru the SMCS. When this virtual terminal Cprogram) signscon to 
a specific anolication programs itt becomes "attached". ALL non- 
prefixed input is sent to that Server program for orocessing. CIn 
the example betow, the "$" iS assumed as the Server Systemts SMCS 
“signal character™+ it could be something else.) 


User System 1 Server System 


eee FV a SF aI BSB TBO Be Se wsaintaga a wm om a en we ee a oe 8 oe OS OP Ue , eed ma eP eRe eo ee ee 


SIGN ON AP «-==> SYCOM 4 


eso omveueggceaeevnunggcue cawaeee@~oeoeneowsnupevevevneaeez on eceaoev ee ae 


AP 0 sateen eeenene > SYCOM <"--> NC caee- 

/ 

erem= NC seme > AP 
\-> SMCS 


ee @enmmeaeaenageeesnoaanaeaggcanvnenmens @oaeoaoa4env eee @aspeaeeoeeaeags 


on @e 88 66 68 


ee ef #9 


e<XXK> ocee=>  SYCOM 

CXXX> oo tee e twee ec nnee slatatatetatetetetaietstatetatetatatatetatatete --"> AP 
$<XXX> tase e cer wenecenn=- scalehetatatenate telstataiatatatatatabete > SMCS 
$ZEXX> tem n cc ense ee nns- slahatahatatatattate aie > SMCS =-=> MCP 
$2 <ann> wert t rn er ene nn ome cane en wne > SMCS <---> MCP 


Program~-to-progran input: 


oe ee ey me me wee eee een eee eee eee ee eet ees 
ee eee ee ee ee a NE Ue eee aR OR eet ee Se orm am en 


The message path for program=to-program communications is limited 
to the following predetermined path. Messages can be any format 
and contain any text agreed upon by both application programs. 
The onty prevailing restrictions are maximum “buffersize™ and all 
fessages must be prefixed with a “header™ ("Appendix E"). 


User system 1 Server System 


ARM OND HB SAMA BKB aM Mawe OE Se eT wR ee ee ee ee ¢ en AR Be OB me BOG eet BS we = ow 


AP 0 tree ne nnne ween anne een- ween> NC ovens 


«XXX> Sen a Se eS ee a) ae mo wan wee we (cain va Cogs aa een > AP 
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Section II Concepts and Facilities (Revision a") 
For the Extended Level System 


In this configuration (Figure I1I*10)» the SPO and all terminals 
attached tor and owned by» SYCON normally communicate with tocal 
SYCOM. When the virtual terminal capability is utilizedse these 
devices are permitted to communicate with either the system 
software programs or appropriate application programs in a Server 
System. 


The SPO» pragram-to~SYCOMe and program~tocprogram input message 
paths for this software configuration are the same as those 
defined for the “Entry Level System". The below message path 
assignments are for ftocal terminals attached to this systam:?: 


User Systen 1 Server System 


nee a @& oe mw wa MMDBn ee ean e SF oF ss we m= ee ese St ee meee ee SS ee oe maw a § ev me ee eee me ee ea e@ewoe. = @ 


o<XXX> s-e""> SYCOM 


By entry of the ".CONNECT"™ command to SYCOM the virtual terminal 
capability is invoked. The following message paths are then 
established for the terminal: . 


i 
«CONNECT -e--> SYCOM ! 
i 


*#ee @eeeeenwneeseeov ee @eeocvunrvananeeveeoekeeaee © ose ne 


e 
e 


VOT -==> NG. “S=> “SYCOM: =-=s> ONC: <==*=> 
: / 
; seee~ NC ==-=> SMCS 


@eaenenmnevasveeveeeeteevne, Be aenvaene aesenaeaen eaeeeneenne 


. | ! 
o<XXX> er => SYCOM 1 


66 06 86 «686 


EXXX> wer sera anannan am em ae ee an nF on a Un a oe Om me mn ae ee an me a am > SMCS 
LEXA ORS SS eS eee “samme (ete ladaded om an eo on os oe > SMCS -<-=<-> MCP 


CSM, SO eee eee eet een een SMCS. =2=> MCP 
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If_there_is_no SMCS currently runqing in the Server _Systear then 
the message string 18 intercepted by the Network Controller which 
causes an error message to be displayed on that system's SPQ. 


Nhen_a_SMCS_is_ cunning in the Server System» the terminal user 
can either “signton"™ to a program in that system or initiate RSC 
type commandss thru the SMCS. When a virtual terminal signs-on 
to a specified application programs it is “attached™ to that 
program. Alt further non-prefixed inout tS sent to that 3rogram 
for processing. (CIn the example bellows the "S$" character is 
assumed to be the Server System's SMCS “signal character™s it 
cautd be another character.) 


User system i Server Svsteam 
2 ee 8 ee ER a mn OD OP om on oe ON wn U8 Oe SF OF OD ae ow ae on me on am we oe Ge Ot Em 8 oF a we we ae oe § weemwmere ue wee eee eee eee ee ee 
] 
SIGN ON AP ett ew ewes ewes weer mem meee me enecamamowacany SMES 
t 


VDT “=> NC a> SYCOM oom)» NC oom ew 
/ 
=ere NE: “See AP 
\7> SMCS 
1 
o<XXX> cwe-"> SYCOM { 


CXXX> oo teense nese eee wee mee mee tem enn e eres eeeen> AP 


ee e808 te 


B<XXX> ae eee a Be ee EF ae EGF OF OI aD en Ot GS ok GR OR OS UT On SP ©) a Am OH On GH OF om aD on on Ge op am an on SMCS 


SIEKKSY (eee eeeas meee wane nneeneeenne n> SMCS ===> ACP 
SZENNND> armrest n tener n eee mneetenn> SMCS oto > MCP 


For the Ultimate Level System 


ma 6) oF of ee at ot on we ok EE en A oy SR ow a ew CS on SI ek ok WS a ee 


In this configuration (Figure [TItl1])» att local terminats are 
attached tor and owned by the SNCS. Thereforer the normat nessag?2 
communication path is to the Jser Systemts SMCS. Hhen the virtual 
terminal capability is uttlizeds these terminals are permitted to 
communtcate with either systen software programs or approodriate 
application programs in the Server System. - Additionally» these 
Same terminals are permitted to communicate with any appropriate 
application proyram in the User System. 
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The SPO» Program=to-SYCUOMs» and Prograr~to-Program input message 
paths for this software configuration are the sam2 as thos2 
defined for the "Entry Level Systam". The following message path 
assignments are for atl tocal terminals attached to the User 
System's SMCS. First the normal nessage paths for terminal input 
Within the User System are presented: 


User System 1 Server System 


mane eee See ee ee RO Me SE SOS OS PS eo eH Ete ee ee {er ernamnmaane aaeaoememewawn ss = eonuwnamnm me 


<XKX> aeee> “SMCS 
ZEeXX> =~ee-> SMCS ~-~> £=MCP 
Z<nnn> w=2777> © =6SMCS s> MCP 


In crder for the terminat user to gain access to the syst2n's 

SYCOMs the terminal user must enter the SMCS "SIGN ON" command as 
shown below. CAlLthough this examole is for a sign=on to SYCOM> it 
could be any appropriate application program tn the User System.) 


ee wa 
SIGN ON SYCOM smertrnrnr> SMCS 1 


The fotlowing message path assignments are then in effect for alt 
terminal input. 


@eoee@etweevuweoenmtaeeeapeneeseeanvnegseeeeenes eesveve8ve 


VDT "> NC ses"> SYCOM t2"-> NC sees 
: \-> SMCS) / 
: wnere NC se==> SYCOM 


aeeeempeenenoeeseesvenaeeweoeseoeseseenereeeseneeeesvese 


td es 86 e8 e868 


eOKXK> “oer > SYCOM j 
eOXKXX> smeermnr> SNCS 1 . 
#Z<XX> ct eree > SMCS ° ==> HCP 


aZennn> ws0e > SMCS “<> MCP { 
] 
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The “virtual terminalt™ capability is tnvoked when the terntinat 
user enters the “.CONNECT™ command to SYCOM. Following are the 


message paths now established for the terminals tf a SMCS_is5_ not 
cuccently cunning in the Server system: 


User System 1 Server System 


eCONNECT "77> SYCOM i 


eeeaeeus»4#svsvsesefteenveaeeeneveeneaenegeeeoeeeeenreeseeees 


VOT <=> NC coe> SYCOM s-==> NC seeee 


ae 06 68 G6 


\=> SMCS : / 
3 aaa” NE 

i 

o<XXX> wee=> SYCOM { 
<Kh AO ¢ “Sees ee e= Pie e aS eS eS Sea ae --> NC "==> SPO 

e<XXX> cew=> SMCS ] 

*#ZEXKX> seenw> Secs --> MCP i 

#eZonan> ~e""> SMCS => MCP i 

j 


If_there_ is no SMCS _ currently cunying in the Server Systene then 
the message string 18 intercepted by the Network Controller which 
displays the message text on that system's SPO. 


When there is a SMCS currently cunning in the Server Systeme then. 
the following message paths are established for a terminal: 


ee ee ee ee ee ee 


VOT ==> NC o="-> SYCOM “--"> NC sree 


\n7> SMCS : f 
| : weet: INC: eke: SMES 

t 

oSXXX> ate > SYCUM { 

“XXX > meee rae a Se Se ee ES 

LAF SS Sees See ee ese pees “SMES “ea UACP 
ERO RS. SSS ee inn ene eer wes SMCS Se MCP 

#EXXX> se--> SMCS { 


&7<XX> -2-=> SMCS “s> MOP ' 
weZennn> "77> £#SHCS “=> MCP { 
i 


SYCOM Software Operationat Guide . 30 Nov 1978 
Company Confidential --rr7- Santa Zarbara Plant Page = 58 


Section II Concepts and Facilities. (Revision "a"™) 


With the SMCS running in the Server Systems a terminal user can 
either "sign-on" to a program in that system or initiate RSC type 
commandss thru the SMCS. When a virtual terminal is signedton to 
a specified application orogramns it is “attached” to that progran 
until the terminal user “signs-off". Alt non-prefixed inodut ts 
sent to that application program for processing. CIn the examples 
belowe the “**" character is assumed to be the User System's SMCS 
“signat character” and the "$8" character ts assumed to 62 the 
Server System's SMCS "signal character"“s they can te different.) 


mee mm 8 Ma Ie eH Oe ee Oe em ew oF C8 mm Ce wD = OF aan @ ww @ ae eo E =a me 


SIGN ON AP See a ge gee ee can awe ne nae a ee ee unm we ww y SMCS 


ewe eeoeeceaenseeecevvanveenwmeseeaeweavueanoveenaecaeonsee@ee 28 


VDT ==> NC one=> SYCOM ==""> NC noeee 


Vn > SMCS : / ; 
$ seme” NC, owe >: AP : 
: \n> SMCS : 
{ 
eSXXX> weer > SYCOM { 
£2XKX> Sese > SMCS | 
#ZKXX> een > SACS --> MCP { 
*#Z<nnn> -eeee > SMCS =>. -MCP { 
CXXX> 9 tees e en anecen aaa katateataatate wren m amen eomnen> AP 
SEK CSE re eee Sees S Se See Sela SA Se ree wanes SMCS 
EZEKKO (SSK SR See Shes Ke Se ese Se Se ae “=> SMCS => MCP 
$Z<nnn> =""-" SF ae Ss ee Mee Se Seer eee Se ah ee ee > SMCS ="> MCP 


Pee are a Ree ee Dicey adie di creas cdltas Eiewrdancdionadiavdiadiieetliaadiecenl 
FO ere me ee ne ee ee ee en ele Ne Se Ue we 


In the SYCOM operational environment» there is a MCP controlled 
data path which exists between SYCOM and the Network Controller. 
This data path is referred to as the “remote file” (Cor message 
queue) mechanism. Oue to differences in data comaunication line 
transmission rates and peripheral input speeds» this remote file 
becomes a buffer. Without some kind of control on the message 
traffic thru this filer tt could grow beyond reasonable limits or 
be jammed full. 
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To provide a control over the nunber of message blocks that can 

be queued up in this file at any given timer a “marker message" 

system is employeu. AS SYCOM is outting message blocks into this _ 

file» a count is maintained. When this count reaches the halfway 

point of the queue depth timite a marker message is put into the S 
file. The marker message is a specially prepared data message (Q 
with a code in the message header. This spectal code ensures 

recognition by SYCOM when this message 18 echoed back to from the 

Network Controller. 


Once a marker message is placed into the file» SYCOM continues 
putting message blocks into the file until the predetermined 
queue depth Limit is reacheds> at which time peripheral input 
operations are suspended. When the Network Controtler encounters 
the marker message during the transmission of the queued message 
blocks» it acknowledges receipt of a marker message by returning 
a"“flag™ in the corresponding "ACX" message to SYCOM. When SYCOM 
receives this acknowledgements it resumes peripheral inputr again 
places a marker message into the file and continues putting 
message blocks into the file until the predetermined queue depth 
is reached or untit an end-of-file conditions whichever occurs 
first. 


SYSTEM FILES 


ee ee ee er ee we ee ee ee 
ee a ee owe me Pe A ee ee 


In the totat system pictures there are many files and fila types. 
Howevers as this system overview pertains only to SYCOM and its 
relationships» onty those pertinent files which are required for 
SYCOM operations are presented. Fotlowing are file descriptioanse 
by software elLementse that are necessary for SYCQM operations: 


MASTER CONTROL PROGRAM CMCP) FILES 


2 
Ce ee teed 


CSYSTEMI/USERCODE File 


This file contains alt valid.usercode~pnasswords that are known 
to the system. Tt 1s used by the MCP to enforce file Security 
disk files and programs/users that access them. With this file» 
the MCP can service any requests dy programs regarding validity 
of specific usercode~passuword combinations. 
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Network Information CNIF) File 


This file contains tables that describe the physical and logical 

attributes of the network. The initialization vatues for lines» 

terminals» and file tables of Network Controller are contained tn 
this file. This file is created by the NDL compiler when it ts 

in the process of generating a Network Controtter. | . 


SYCOM FILES 


The Systems Communications Module utilizes many types of files in 
the management of its domain. There aree peripheral Cinctudes 
disk)» remote communicationse and queue files. These files are 
briefly described heres under seoarate headingse with detail 
descriptions for major files available in the appendices. 


Peripheral Files 


These files are generally used to input/output RJE type data and 
include the card reader» card punzhe Line printerr magnetic taper 
and disk files. Atso there is a disk file which is used by SYCOM- 
to manage the various options and settings. Following are general 
descriptions of the SYCOM files which fall into this category: 


Ae PARAMETERS File 


The PARAMETERS file is a single record file containing 
required operational parameters for SYCOM. It is static 
and can only be changed sy removal and recreation. This 
file is created by SYCOM upon the entry of approoriate 
parameters from either the card ceader or the User SPO. 


Bo Card Input File 


This file ts used to input RJE card data files from the 
system's card rgader. Jt can be either a 80-column or 


6-column device: 
) (As 81- 1h ig noreat. 
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Card Output File 

This file is used to punch RJE card output data files to 
the system's card punch. It can be etther a 80-column 
or 90*column devicer as appropriate. 

Printer File 


This file is used to print att RJE print files that are 
beings or have teene received from a Server Systam. The 
line printer device can by any one of the various models 
that can te attached to the systems which can b2 either 
a 120-position or 1327~position tine printer. 


There is an additional orint file which is used to list 
SYCOM's “*TRACE" or “"OLOTRACE" files via the ".LIST" 
command? it goes not interfere with printing the RJE 
type print files received by SYCOM. 


iles 


The remote files are used in comminications between SYCOM and the 
Network Controller and SYCOM and 2ither the terminals or SMCS. 
There are two of these files which are described as follows: 


Ao 


LINK File 


The *LINK™ file is used for all input/output messages 
relating to RJE and file transfers> specifically, 
Station types for Controls SPO» Cardse Printere and 
File records. 


TERMINALS File 


The “TERMINALS” file is the communication link between 
SYCOM and the Network Controller for tocat terminat 
messagese This remote file ts howevere only used when 
there are tocal terminals; controlled by either tha 
SMCS or SYCOM. 
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Queue Files 


The queue files are utilized oy SYCOM for buffered communications 
between itself» the HCP» and the Network Controller. The purpose 
of each of these queue's is described as fotlows: 


Ae RJE Queue 


Used to save printer/punch data received from the other 
system when the User System's printer or punch is busy. 


Bo LINK Queue 


le Used to save input messages from the other system 
during the "initialization" phases else they may be 
lost in the shuffle. 


2e Used to Save output nessages for the other system 
when “messages queued™ exceeds “MAX“MESSAGES". 


C. INQ Queue 


This queue is the mechanism by which SYCOM sends reply 
messages to an application program deating tn proaraa~ 
to-SYCOM communicattons. SYCOHW “writes” into it and the 
application program “reads” from it to obtain messages. 


Da OQUTQ Queue 


This queue is the mechanism whereby SYCNOM receives tnout 
command messages from an application program that deals 
in program=to*SYCOM sommunications. The application 
program “writes” into tt and SYCOM “reads* from it to 
obtain input messages.’ . 
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RESTRICTIONS 


ee ew Ye ey ee ee ae 


The following restrictions are valid for the syst2m based on 
Logical evaluation of the system's requirements: 


« Maximum message block size = 1950 bytes 

« Minimum message block size = 78 bytes 

« Maximum simultaneous system connections = 1 

- Maximum message block queue depth = 255 

° Maximum numder events queued to process = 99 
- Maximum number of terminats supported = 15 

« Maximum number of card feaders supported = 1 
« Maximum number of card ounches supported = 1 
- Maximum number of tine printers supported = 1 


1978 
63 


"a™) 


« LOAD.~DUMP tapes are not supported for fite transfer 


operations. 


» Between unlike systeas» only file transfers of code 


files and 66-bit data files are allowed. 


* Onty "data type files" are file transferable between ~ 
disk/tape and tape/disk Ccodes files are invatid). 


« HMulticrpoint networks are not supported by SYCOM? 


at this time. 


« Message blocking is prohibited. CA message block 
atready contains multiple records or data images.) 


- Monitoring and controlling of programs in the Server 


System reguires a SMCS executing in that systea. 


* This system does not suoport “binary-synchronous” 


communicationse 


These restrictions may be changed during subsequent development 


cycleses but are howevers currently tn ef fect. 


SECTION III 


ee Om ee et ee eee me cars mee ee ee es met ee er Or RT ee mee AE SO ern me ew ee en ee cee we ert ee UR Am we em we ais ae oo 
eee eee ee ee Oe et OO ee ee ee a ge er om a are er a a OR ee Gm ame Ew Or Om we Om a OR Ee ee ae mee 


COMMANDS 
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SECTION ITI 


COMMANDS 


Cee ee ee oe ee ee 8 Oe ee ee Oe ee ee Oe ee ee ee Oe ee ee ee 2 Oe ee 2 2 ee ee ed 


GENERAL 


— eee me rm cer ee oe 


The commands available with the Systeas Communications Module 
CSYCOM) are described in this section. These conmands are used 
to give SYCOM directions as to specific actions which must 9e 
executed in order to perform the required tasks. The commands 
are presented alphabetical order aithin two groupss those allowed 
from terminals and those restrict2ad to entry from the system SPO 
or programe This way» the terminal user need not be encumbered 
with the details of SPO commandss which are not permitted. 


To ensure that each command is phystcally separateds a unique 
format presentatione khich is described hbetow» has been developed 
for this document. This scheme of formatting presents commands 
in modular format which allows for expansion and change without 
significant disruption of existing syntax. : 


COMMANDS 


mentiecediih aadiieendiiectine litindiaed 
ee et ee ee ee 


Each statement in the Command Language consists of a command andr 
in some casesrp a list of parameters. The parameters in the list 
are separated from the command and each other by blanks. In the 
following examples single spaces are used although the use of 
muttiole spaces between command elements could be used. 


When the SYCOM has finished processing a commande it displays a 
reply messaye either confirming successful completion of the 
command or indicating an error. irrors terminate the processing 
of a commands the entire command must be re~entered correctly. 
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COMMAND SYNTAX CONVENTIONS 


The notation conventions that are described below are used 
throughout this section to describe the syntax of each command. 


Notation used in model format 


First» a modet of a command is prasented.s. This gives the user an 
overview of the potential of the command structure. 


Wee Hee ee RMS KTH HES BEES KR eS BSF MESS OAKH AS Sew aati sere weeaanecgazgwsws Sage aea aesumwaqae 


eCOPY <filernamer-1> (CCUSER=<usercode>)] (CAS Tete meme mma > 
ONTO 


we==> 8 <file-name-2>] FROM CHOST=<id>) TO CHOST=<id>) 2 


88 66 ¢e@ 26 ee ~e@ ee @6 68 
0 80 86 v0 oe 80 ef se 08 66 


BRACKETS: Information that is enclosed within brackets (} 
represents 3n option which may be used or omitted by the user. 
In the model example given abovere the options USER» AS or ONTO? 
and “filesname~2" indicate three sossible choices when using 
these options» or the choice of not using any option. 


BROKEN BRACKETS: Left and right broken <>» brackets are used to 
indicate that the enclosed variable within the brackets must be 
replaced by digits and/or tletters whose value is determined by 
the context of the command. 


UPPER CASE LETTERS: Words that aonppear tn upper case letters 
indicate that the word 1s a literal and must be substituted 
verbatims when useds In the aodel given abover the word .COPY. 
would be entered first when constructing a command statement. 


LOKER CASE LETTERS: Words that aopear in lower case letters 
indicate that a vatue must be suoplied. In the model aboves the 
word "“filesname-1" indicates that a character string representing 
the name of the file to be copied must be entered.- 
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COMMAND STRING SYNTAX CONTINUATION? A few of the commands have a 
considerable number of syntactical items which overflow a printed 
line into two or mere command string Lines in the presentation. 
To provide a clear tine of continuation for the command string» 
the use of Line direction arrows are used. A Line direction 
arrow appears aS “"-"""> and always flows Left to rights to 
continue the command string. It #S easy to follow a command 
string in this format as it is logical tn nature. 


OPEN“CLOSE PARENTHESES (©): Uhen these characters apoear in a 
command syntax Statement they are required inpute See tha "COPY" 
command for a use reference. 


SLASH /3 When this character app2ars in a command syntax 
Statement it is required input. <A space or Spaces on either side 
of this character are not allowed. 


END OF STATEMENT: The end of a command statement is indicated by 
the appearance of a % (percent sign). I[t is only a Syntactical 
string terminator and is not required text for command inout. 


Punctuation Rules 


The spacer the commar and the pertod are considered punctuation 
marks (except in literals) and ar2 used as follows? 


1. The space (blank) 15 a Separator» required after words 
and Literals in the absence of any other separator. A 
space may precede or follow any other separatorer and 
many spaces are the same as one Cexcept itn titerats). 


2- j.A comma iS .a separator that 15 legal only where it is 
specifically indicated tn the command syntax. The commae 
where it ts tegal» can also serve as a terminator for 
words and numeric titerals. The comma is never requireds 
except to separate criteria in a command string. 


3e The period is a required prefix to Locat SYCOM commands. 
It is never required within any command string syntax. 
Its onty acceptability would be as an embedded character 
in a file namer system identifiers or usercode/password. 
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COMMAND RELATED ERROR MESSAGES 


Error messages specific to the following SYCOM coamandsS adpear in 
Appendix A (Command Error Messages). 


COMMAND SET 


The command set which follows» is used to direct SYCOM oo2rations: 
from either the SPO» a system terminals or an application progran 
running in the system. Non-SYCQM commands are also permitted to 
direct User and Server System operations via respective SMCS‘'s. 
This command set is separated into two subsetss 1) commands which 
are permitted from any device and 2) commands restricted to a SPO 
or special application program. 


Terminal Commands 


The following commands are permitted from terminals. They direct 
file transfer and rewote Server System operations. Although these 
commands are for terminalse they are also permitted from the SPQ 
and special application programs used for system control. However 
when these commands are entered from the SPOr the command string 
must be prefixed With the “job nuaber”™ assigned to SYCOM followed 
by an “AX*" and then the command string. 
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eABORT Commanu 


Ne Ree Reena ne Mian Mood 


Re ed 


Function: The ABORT command is used to force SYCOMN ta “abort"™ 
an invwprocess file transfere either receiving or 
transmitting. If “fetchina™t (receiving)» the file 
created up to the point of aborting ts etther 
removed or purged aS appropriate. 


| Wok A 
Syntax: eABORT FETCH Z 
PUT VW 
Semantics: FETCH = causes the FETCH in=process to be aborted. 
PUT = causes the PUT tnprocess to be aborted. 
Default: None. 
Example 1: (KILL off transmitting the current file.) 


Inputs --= .ABORT PUT 


Reply: =-~ PUT OF FILE <file name> ABORTED 


Example 23 (Stop recetving of incoming file transfer.) 
Input: "= .2ABORT FETCH 


Reply: --~ FETCH OF FILE <file name> ABORTED 


Note: If a file transfer ts not tnmprocess when the 
comuand is enterede an appropriate error message is 
returned. 


@et em e228 2 040 86 
. @ a 


° ABORT . 


*@t*@e C©eOesenaaneeeeeue 
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ee Re Dre aD cred Utne 


Function: 


Syntax? 
Semantics: 
Default: 


Example: 
Inputs --- 


Reply: ---* 


Note: 


This command completely logs the current user off 
SYCOM. It is vatid from att stations tnctluding the 
system SPO and application programs. The following 
sequence of events transoire when it 18 entered. A 
"BYE" text message is sent to the other system to 
cause a “log-off" from that systems the usercode is 
removed» an automatic “DISCONNECT” is initiated» 
and a “detach” message 1s sent to the tocat SNCS> 
if the terminal is not owned by SYCQOM. 


-BYE 2 
None. 


None: 


BYE 


GHOSE YEt SYCOM Cusercode) LOGGED OFF at 11:°45:32.1 


The inittating station need not be "logged-on"™> 
however» under such circumstancer the “Cusercode)" 
part of the reply message is eliminated and if the 
"DEBUG" option is currently ON» then the message 
"STATION NOT LOGGED ON" 15 also displayed. 


eee @ea we eeoae se sea 


. BYE . 
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eCONNECT Command 


ee ae eer ee ne ems eet eet ee eee oe 
a | 


Function: The CONNECT command is used when a terminal user 
wishes to be logged=on to a Server System. Upon 
entry» the User System goes into “*ontine”™ modes 
attempting to establish communications with a 
Server System. If a connection currently exists 
to a host Server Systene then that connection is 
utilized to attach the terminal to that system. 


SYCOM ensures that a MCS type program ts running in 
the Server System and that a "virtual station stot" 


is availabler befor2 the "CONNECT COMPLETED” reply 
message is returned to the initiating terminal. 


Syntax: scomecr (+ ) io —— 


F okie we A 
i \ Pi 4 0 vo wo A 7 


Default: If a user is, logged-on to SYCOMs then that usercode 
and password is foraarded to the MCS tn the other 
system which; automatically logs the user on to that 
MCS. An appropriate “logon reply message" is also 
returned to the teruinal following the "CONNECT 
COMPLETED" massages providing the MCS to which the 
terminal ts attached ts the SMCS. 


NY 


Examples (Request attachment to the Server System.) 


Inputi --- -connecr { vs verse} vik IC conn ted F yet 214 


Reply: ~--7 CONNECT INITIATED 


vw~~ CONNECT COMPLETED 


Note: If the Server Systen 15 accessed via a "Switched" 
tine and its telephone number has been previously 
established by entry of the “PHONE” commands then 
this command tnitiates an automatic dialwout. 


e CONNECT . 


*@e* ea ese emnanea ee te 


me = et oe a le low Ome 
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eT Fe ee ee ee ee ee oe 
na a ee ED ee A SE Re ge ee 


Function: This is the command which is used to inittate "file 
transfers". The command syntax provides for the 
transfer of files "from" the initiating system to 
another system €a PUT) and from another system "to" 
the initiating system Ca FETCH). The files can be 
in etther magnetic tape or disk form and the only 
restrictions that apoty are those identified in 


“"Restrictions",» Section II. 
vst {a/6 


‘ cy) 
Syntax: COPY <file=name-1> fC (Ost R= <usercodent> ooren “=> 
=> PASSWORD=<password=1> 0 --2--- wonen-- wo nnee--> 
‘o) 
=—--> ( (€» €NQA) LIST] (C+ REMOVE) 1) 1 sere ween => 
SAVE 
72, I 
awem> ( AS <file name-2> C (isen-<usercode-2>» “=> 
ONTO 
i 2 
“==> PASSWORD=<password=2> ae eee ==> 
oO oO Piec 
w--> FROM C§xvolume-1>] QCKIND=PACK 4] wennnn--) 
TAPE 
TAPE7 
TAPES 
PETAPE 
Disc 


emw=> HOST=<system name-1> ) TO C<volumer2>]  ----<-> 


Spel | 
“-=> (ckino=Pack *) HOST=<system name-2>) z 
TAPE 
TAPES 
TAPED 
PETAPE 
Din 
Note: An important point to remember 15 bmw meee ence en 
that the “oarens” are REQUIRED oe ‘ 
syntactical elements as well as ° COPY . 
the keyword "FROM"™.. " * . 


eee eaesweoeeneeentea 


ema am at am 
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Semantics: file-name-1 


usercode-1i- 
passuword-1 


LIST 


REMOVE 


SAVE 


AS 
ONTO 
file-nane-2 


usercode™2» 
password=2 


volume-1 


KIND 


it 


"i 


(Revision "a"™) 


name of fite to be transferreds 
including multifile identifiers. 


the usercode/password vatues which 
identify the user for purposes of 
verifying access rights to a file... 


an attribute that implies the file 
is to be printed on the receiving 
System. CApplicable only to printer 
backup files.) 


this attribute causes the file to 
be removed from the sending systems 
after the transfer has been made. 


this attribute is used to ensure 
that a printer backup its “saved” at 
the sending system. 


means create a file with the name 
specified as "“file~name~2". 


means write over any existing file 
Nnam2d as specified (file-nane-2). 


aoname to be given to the file that 


is transferredr at its destination. 


the usercode/password values which 
specify the security to be placed 
on the transferred filasr once the 
transfer has been completed. 


the “pack-id" from where the file 
to be transferred can be obtained; 
providing the following KIND option 
is equal to "PACK". (Not required 
for files on tape or system disk.) 


a syntacticati keyword used to 

describe the peripherat device from 

where the file is 

to 2»e transferred 

frow? if other than cecvcecccsecevce 

system disk. mo e 
° COPY . 
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«COPY Command Ccontinued) 


a na re Re A rene om a me a 
we ee ee NO Sn ee ee Oe 


Semantics: 


Ccontinued) 


Defaults: 


mk ome a se ee a 
—- me ee ee ee oe 


system=id-1 specifies the “system-id™ from 
where the file is to be transferred 


from. 


volume-2 the “pack-id"™ to where the file is 
transferreds providing the 
following KIND option is equal to 
"PACK". This option ts not required 


for files on magnetic tape or disk. 


KIND = on2 of the keywords Shown is used 
to describe the peripheral device 
to which the transferred file is to 
be writtens if other than a system 
disk. 


systemtid=2 the “systen-id” of the system which 


is to receive the file. 


The syntactical item "VOLUME" defaults to “system 
disk" if "KIND" ts atso defaulted. 


The syntactical item KIND defaults to "KINJ=PACK". 


The default for "ustarcode-1" and “password-1" are 
those of the togged-on user. 


The destination usercode/password Cusercode"2 and 
password72) are defaulted to those of the source 
Meee Cleves: worde 


The daseieae on fil2 name (Cfile-name-2) defaults to 
the original name of the file transferred and the 
"AS"/"GNTO" option defaults to "AS". 


The default attributes for printer Backup Files are 
LIST™ and *"REMOVE”™. 


The default attribute for nonwprinter Backup Files 
is "SAVE". 


* COPY . 


ee e@oepevewaeeaeneve 
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eCOPY Command (continued) 


ee ee ne ee ee ed 
St ae we ew cee eet a a ee ee ae a a a ee eee aN WN me ane 


Options: The syntactical abbreviation "DISK" may be used in 
lieu of "KIND=PACK"™. 


The abbreviated syntax "USER=<usercode>/<password>" 
may be substituted for the specified command syntax 
elements so named. 


Example 1: (Transfer file "XYZ" from system A to system Be) 


Inputs --- .COPY XYZ CUSER=<usercode>/<password>) FROM 
CDISK» HOST = USERL) TO CDISK» HOST=SERVERL) 


Replys --- FILE XYZ START TRANSMISSION 
sae FILE XYZ END TRANSMISSION 

Example 2: (Copy file from another system changing file nane.) 

ae 

Inputs 7-7 eCOPY DMPALL AS DOUMPALL FROM CHOST = SERVERL) ie: 

Reply: “~"- FILE DMPALL START TRANSMISSION 


~-- FILE DBMPALL RECEIVED 
--- FILE DMPALL END TRANSMISSION 


t , 
Ne olay SPo 


Kotess 1. In the implementation for file transfers from 
either tape or disk to “tape” in a receiving 
systems if a scratch tape is not mounted and/or 
ready» SYCOM wiilk "hang™ until the tape is made 
availables no notificatton 15 made of this 
condition and only inquiry type commands are 
processed until the condition ts resolved. 


2s If a “usercode™ is not wanted as a multifite-id 
to the file name in the receiving systems» enter 
"“file-nane"2" prefixed with an asterisk "tae, 


@en ee neaeneneaesnen 


ie coPY . 


eae ensenmaeneaeeeene 
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DISCONNECT Command ( 
Function: This command must be used when the terminal user 


wishes to terminate a session with a host Server 
System. The terminal is tLogyged-off of the Server 
System when a "BYE" text message is sent to the 
other system which is fotlowed by a “disconnect”™ 
message. The terminal reverts back to tts previous 
State of being signed-on to SYCOM. The terminal 
user is then free to enter sore commands to SYCOM 
or sign-off (.BYE). 


Syntax: eDISCONNECT &£ 
Semantics: Nonee 

de faures None. 

Example: 


Inputs ~"- DISCONNECT 


Reply: we~ STATION DISCONNECTED 


Notes: 1. The terminal is logicatly disconnected but may 
or may not be physically disconnected. To the 
terminal user however» the effect is the same. 


2. If auser is tlogged-on to the SMCS in another 
systems then an automatic “logr-off"™ witl occur 
for that virtual station. 


*eenae eoee@eeoeuaensne eas 


~ DISCONNECT . 


eeaeepoenaoeaeoneene @ee 
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Section III Commands (Revision "a"™) 


eFETCH Command 


mee a ee me oe me cee ee nee 
ea ek eS me Om ety ee aD 


Function: This command is the shorthand version of the "COPY" 
command for use in specifying explicit "FETCH" file 
transfer requests. The command syntax provides for 
transferring files From another system “to™ the 
initiating system (a FETCH). Files can be either 
magnetic tape or disk Cin any combination) and the 
only restrictions that apply are those-identified 


in Section II» “Restrictions”. 
Us (a /¢ 


Syntax: eFETCH <file=namer1> CQUSER=<usercodecl>» <““**--=> 
@ 
“<=> PASSHORD=<password=1>) lalateteleiatettetetetatatatatete “=> 
x x 
“--> { (€» {NOJ] LIST) {> RENOVE) ) J ease newnae=> 
SAVE 
aes> [AS <file name-2> ((USER=<usercodet2>» -“"=> 
ONTO . 
o> PASSHORD=<password=2>)) dp eR Ne ee mn eS 
orgie 
wt 
““=> {FROM {C<voluner1>] C(KIND=PACK 3. =S=e<s> 
TAPE 
TAP EZ 
TAPES 
PETAPE 
Deg 
PISte 
~--> {TO C<voluma-2>) CCKIND=PACK yn 1 
TAPE . 
TAP EZ 
TAPES 
PETAPE 
Note: If a “usercode" is not desired as 


a multifite-id to the fite name on 
the receiving systear then prefix 
*file-name"2" with an asterisk "*", dial a ae fa te ee a 


. FETCH . 


eee ope eeneva eoeoeedsee 
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Section [II Commands . (Revision “a") 


eFETCH Command (continued) 


ae ee sees cae er owe mem ee ee er ee ee, ee 
a a A OD a eS eles a ee ee ee ay 


Semantics: Refer to the "COPY" command semantics. 
Defaults: Refer to the "COPY" command defaults. 

Options: Refer to the "COPY™ command options. 

Example 1: (Obtain a copy of the "DMPALL™ program from the 


Server System.) 
Input: =-"~ .FETCH DMPALL 


Reply: w-~ FILE DMPALL START TRANSMISSION 
mem FILE DMPALL RECEIVED 


--- FILE DMPALL END TRANSMISSION 


Note: In the implementation of file transfers from either 
tape or disk to “*tape" in @ receiving systen» if a 
scratch tane 185 not mounted and/or purged» SYCOM 
will “hang” until the tape ts made available: no 
notification iS made and onty inquiry type commands 
are processed until this. condition ts resolved. 


iad FETCH e 
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Section III Commands (Revision "a"™) 


eLIST Command 


ran eee ees re ee me eee ey ee 
at ca cee Sm ee a eee ee 


Function: 


Syntax: 


Semantics: 


Default: 


Example ls 


Input: 


Repty: 


This command is vatid from any terminal or the SPO. 
Its purpose is to display tnformation about the 
system and its users. Command options provide lists 
of current system “paraneters™» users currently 
"signed-on"r terminals that are currently “*online™ 
and file transfers currently “scheduled” to occur. 


eLIST PARAMETERS z 


USERS | 
TERMINALS 
SCHEDULE 
TRACE 
OLDTRACE 
PARAMETERS = requests a tist of the parameters 
SYCOM 15 currently operating with. 
USERS = requests a tist of all users currently 
“"“signed-on" to SYCOM. 
TERMINALS = requests a tist of att terminals that 
are currently “online”. 
SCHEDULE = requests a list of alt file transfers 
currently scheduled. 
TRACE = prints the "SYCOM/TRACE™ file. 
OLDTRACE = prints the “SYCOM/OLDTRACE” file. 


Currently there ts no defautt.. 


(List alt fite transfers "“scheduled"™ to occur.) 


eLIST SCHEDULE 


~ LIST . 


eon @@m ev aeaeeveanee 
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Section III Commands (Revision "a™) 


eLIST Command C€continued) 


cs ene NO NE AY eh ey a ee ee es 
ed 


Example 2: {List the current signed-on users of the system.) 


Input? --~- .LIST USERS 


isu 


Reply: -"- (<see®ronr=tapte>] DENNIS CONNECTEOL mi Ne aA 
--~) 0 <Seeeronm-tabte J] JEANNE NOT CONNECTED 
aww 6 < ReeEten—tabier>)] CARLYE CONNECTEDL. “S AL 4 A 
ww- 3 USERS LOGGED ON TO SYCOM 


Example 3: (List the currently “online™ terminals.) 
Inputs "2 .eLIST TERMINALS 
Repty: -<"- (<tsn>)] <SPO> <v.e-isn> Aa ad 


wae 2 TERMINALS IN USE 


Exampte 4: (Display a List of SYCOM's current parameters.) 


Inputs «*~ .LIST PARAMETERS 


Reply: ~=- MAXIMUM BUFFER SIZE 1990 FOR FILE TRANSFERS 


DEBUGGING OFF 
DISK TRACING OFF 4 *© 10 * 10 = 400 RECORDS 
PROGRAM INPUT ALLOWED 
FILE TRANSFER ALLOWED 
FILE SEPARATORS SENT 
WAIT FALSE 
TIMEOUT INTERVAL. = 25 Cif DEBUG option is "ON") 
SYSTEMID = "USERL om ee 
Note: When either the TRACE or OLDTRACE option is entered 


With the ".LIST™" commands no reply message will be 
returned to the initiating terminal. 


° LIST . 


eeeseeoeanenmveseseenervaea 


— 2 on = ae we 
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Section [II Commands (Revision "™a™) 


ePUT Command 


ney eee ee ee 
on cee ee ee ee es oe ee 


Function: 


Syntax: 


Note: 


‘in Section IJ» "Restrictions". 


This command is a shorthand version of the "COPY" 
command and is used to specify explicit file "PUT" 
transfer requests. The command syntax provides for 
transferring files "from" the initiating system to 
another system Ca PUT). The files can be either 
magnetic tape or disk Cin any combination) and the 
only restrictions that apply are those identified 


| US = < use reoda—iy /e pessuce! 
.PUT” <file-name-i> ((isen=cusereodent>. secwseeely 


“==> PASSWORD=<password-1 


nm =e wt 


---> ( C+ €NO] LIST] fr REMOVE ) 7; seemesesens 
SAVE 
C reerss Site | 


menw> CAS <file name-2> ((user=<usercode=2>, ~a=> 
ONTO 


pala P ASSWORD=<password-2>) Da. Seer Race Se a a > 


DISic 
wew=> CFROM (C<volume~1i>) (stnp=P ack ) a: Se * 
TAPE 
TAPE? 
TAPES 
PETAPE 
DEC 


¢ DIS IC 
e--> (TO {<volume“2>] { KIND=PACK ] j z 
TAPE 
TAPE? 
TAPES? 
PETAPE 


If a "usercode™ is not desired as 

a multifilerid to the file name on 

the receiving Systene tnen prefix 

“fjile-name"2" with an asterisk "*", ceessecvesssvce 


= PUT e 


eeneesespesesee#eeer# 
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ePUT Command Ccontinued) 


—_— oe ae em we ee ne ee eee oe 
ae a a a ee a a a oy 


Semantics: 


Defaults: 


Options: 


Example 1: 


Input: 


Reply: 


Examole 2: 


Input: 


Replys 


Notes: 


eee eee ee ee eee ee 
a ee ee ee 


Refer to the "COPY" command semantics. 


Refer to the "CUPY" command defaults. 


Refer to the "COPY" comnand options. 


(Send. the program "TESTL6" to the Server System f 
execution. ) 


ePUT TEST16 


FILE TEST16 START TRANSMISSION 
FILE TEST16 END TRANSMISSION 


(Send a printer-backup file to the “"hub™ system.) 
PUT CSP0)/#2121 CSAVE) 


FILE CSPO)/7#2121 START TRANSMISSION 
FILE CSPO)/#2121 END TRANSMISSTON 


1. In the implementation of file transfers froa 
either tanoe or disk to "tape”™ in a receiving 
systems tf a scratch tape is not mounted and/ 
ready» SYCOM will “hang™ until the tape is ma 
availables no notification is made of this 
condition and only tnquiry type commands are 


processed until the condition is resotvead. 


Referring to example 1% Upon completion of ¢t 
"PUT" file transfers the following ressage is 
displayed on the SPQ of the “other™ system: 


% SYCOM =<jyob #> FILE TESTL6 RECEIVED 


This is atso true under the 
reverse circumstancesSe 

. _@@eeoeone saves es 
se 
‘ PUT 
‘ 


®*acoseegeeaedeeese 


78 


82 


") 


or 


or 
de 


he 
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Section III Commands 


USER Command 


on am eee me ee eee ee es ee 


oe en ae a a a a aD ae ame 


Functton: 


Syntax: 


Semantics: 


Default: 


Examples 
Inputs --- 


Replys --- 


Note: 


(Revision a) 


‘Sch ny & LE 


This command is valid from any source. Onc2 the 
statement ts entered» the “usercode/passuord” is 
Storeds without vatidation. This data is forwarded 
to the other system for "CONNECT" commands and is 
used for file transfer purposess as the default 
usercode/passSword when none 15 specified. 


eUSTERI] <usercode>/<password> 2% 


usercode = a predefined user identification. 
password = a predefined user security code. 
Nonee 


CLogton to SYCOM.) 
eUS MY/USER 


USER MY/USER LOGGED ON TO SYCOM 


If a “*usercode"/"password"™ is atready togged-~ons 
the current log-on attempt is stitt allowed and. 
takes precedence. 


* USER . 
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Section III Commands (Revision %a"™) 


eHHAT Command 


ee eet ee ee ee ee mee ee 
ee ee ee 


} 


Function: The «WHAT command solicits the return of areply 
message indicating the current "status" of SYCOM's 
processing activity. The reply message is variable 
in length and content to reflect as many conditions 
as possible. If any file is tin the process of 
"transfer", its name and the number of records thus 
far transferred is displayed. 


Syntax: eHHAT Z@ 

Semantics: None. 

Default: | None: 

Example 1: (Assume at the tine iis comnane is entered» SYCOM 


is connected and waiting for something to do.) 
Inputs --- .WHAT 


Reply: ee- SYCOM ONLINEs TOLE 


THIS STATION CONNECTED USERCODE = SPO, 
LOCAL HOST = USER1I-e REMOTE HOST = SERVERIL 
Exampte 2: (The command is entared during a file transfer.) 
Input: ~*~ WHAT 
Rephy:s =-"- SYCOM ONLINEs 09 FILES QUEUED; 
SENDING: OMPALLO 70/82); 
THIS STATION CONNECTED USERCODE = S?0O> 
LOCAL HOST = USERL>» REMOTE HOST = SERVERL 
Note: The context of a WHAT reply is extremely fluid in 


that it is representative of what is happening at 
the time the command is entered. Because of the 

number of combinations of events that could be in 
progress at any given timer tt 

is not feasibke to attemnt. to 


exanple them all. Howewers the Pe ee ge eae a ae 
exanples ahove will give vrovide - . ° 
the user With some tdea as to " WHAT . 


what can be expected. ‘ ‘ 


eat @aeeeeeaee aeeave 
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Section [II Commands CRevision “a™) 


#<SMCS Command String> (User System) 


a ee eee ee ee ee er ee ee eee 
pope en a ee ee ee ee ee ee 


Functions: This command syntax atlows a terminal user on the 
User System to give commands to the system's SMCS 
for processing. Commands entered from a terminal 
that are prefixed with a signal character of “«" 
are intercepted by the Network Controtler and are 
immediately sent to the SMCS for processing. 
Consequentty» the entire range of SMCS commands are 
available to a SYCOM user with this command syntaxe 


Syntax: -  #€SMCS command> C<attributes>] Zz 


Semantics: SMCS command = any SMCS command which is valid from 
a User System terminal. 


i 


attributes = any data elements that are required 
by the command syntax. 


Default: None. 


Example: 


Inputs -e"- *FILE CJEANNED/GUIDE 


Reply: w-"- "CJEANNE/GUIDE® IS A PUBLIC FILE OF 
188 RECORDS (90 BYTES» 20 PER BLOCK) IN 
19 BLOCKS (10 PER AYtEA» 1 AREA) CREATED ON 
O4/24/78» LAST ACCESSED ON 
06/21/78 CACCESS SEDURTTY IN INPUT<-QUTPUT) 
AND CURRENTLY IN USE BY 4 USERS 


Note: For a comptete tist and descriptions of the SMCS 
commands available, refer to the "SHCS Software 
Cperationat Guide" 


aeeeo8#eeeeevtedqdeee 
a eo 
e *<€coamand> . 
° . oy 


@ageeenenee_eteeon es esea 
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Section TII Commands (Revision "a™) 


*Z <SMCS/MCP Command String> (User: System) 


ee he a. a a a ed 
ee ner a a ae a ee ee ee ee 


Function: This command is used to initiate directives to the 
User System's MCP for processing. By prefixing the 
command string with the tocat SMCS's “signal 
character™s the Network Controller message switches 
this command string to the User System's SMCS which 
in turn zips it off to the MCP for processing under 
the following ruless assuming that the terminal is 
a Remote SPO: If tha "Z" is inctuded or the user is 
*not"™ Logged~one then the command string is zioped 
“"unsecure™ else it 1s zipped “secure”. 


Syntax: *{Z] <XX> <mcp command attributes> 3% 


Semantics: XX = any MCP command code Cor 
job #) that would de valid 
from a Remote SPQ. 


any data elements required 
by the command syntax. 


mcep command attributes 


Default: None. 


Example: (Request a directory list for the logged-on user.) 
Inputs <7" «PD =/= 


Repty: we- PD= "DCHCODE" 
PD= “DCHSOURCE* 
PD= "#DUMP™ 
PD= "“PROGRAMX"™ 
END PO 


Notes: Le A “mcp command string” ts made "“secure™ with a 
usercode/password prefix and a sesston number 
value equal to the user's usercode~tindex. In an 
“unsecure” ncp command string these attrioutes 
are excluded. 


Ze Refer to the “Restricted ACP 


Command Summary» Appendix F we mecca ncecasne 
for a “secure™ command list. = ‘é 
rf e «ZF <XKX> ,. 


@eeeatseneeneesseeneet een 
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Section III Commands i (Revision a") 


<x><SMCS Command String> CServer System) 


=~ a ae ee we Oo ee ee a ee ee ewe te ee ees 


Function: This command syntax allows a terminal user on the 
User System to give commands to the Server System's 
SMCS for processing.s Each command entered must be 
prefixed with the current signat character for that 
SMCSs it must be different than that of the User 
System's SMCS for onvious reasons. Alt messages 
with thts signat character are tinterceoted oy the 
Network Controller and inmediately sent to the SMCS 
for processing. Consequently» the entire range of 
SMCS -commands are available to a SYCOM user. (This 
command is onty valid when a SMCS is running in the 
Server System.) 


Syntax: <x><SMCS command> Ccattributes>}] 2 


Semantics: x = the Server System's current SMCS 
"signal character". 


u 


SMCS command any SMCS command which is valid from 


a User System terminal. 


attributes any data elements that are required 


by the command syntax. 
Defaults None. 


Exampte: (Request some file attributess the Server System's 
"signal character" is assumed to ba "$%.) 


Input: ~*~ $SFILE CJEANNE)/SGUIDE 


Reply: r= *CJEANNE/GUIDE® IS A PUBLIC FILE OF 
188 RECORDS (90 BYTceSe 20 PER BLOCK) IN 
19 BLOCKS (10 PER AREA» 1 AREA) CREATED ON 
O4/24/78» LAST ACCESSED ON © 
06/21/78 CACCESS SECURITY IN INPUT-OUTPUT) 
AND CURRENTLY IN USE BY 0 USERS 


Notes: Nonee 


ee se @eaoeeee#@eseeseteeaea 
« “xX><command> . 
2 e 


SYCOM Software Ooerational Guide . 30 Nov 1978 
Company Confidential -"-*- Santa Barbara Plant Page = 88 


Section ILI Commands (Revision *%a™) 


<x>Z <SMCS/MCP Command String> (S2rver System) 


ee ee ee ee ee ee ee Se 


Function: This command syntax allows MCP command strings to 
be sent to a Server System's MCP for processing. 
The key of course is the “signal character"s it is 
the current Server System's SMCS signat character. 
It must be different than that of the User System's 
SMCS signal character of obvious reasons. Once a 
command string 1S entered» SYCOM transmits it to 
the Server Systam for processing by the SMCS/MCP. 
Whether or not a couamand string is zipped "secure" 
is determined by the rules outlined for the User 
System's SMCS/NCP> reference page 86. 


Syntax: <x>€Z}  <XX> <mcp coamand attributes> 2Z 
Semanticss x = the Server System's SNCS 


Signal character. 


XX = any MCP command code (Cor 
job #£) that would de valid 
from a Remote SPO. 


il 


mcp command attributes any data 2tlements rieaquired 


by the command syntax. 
Default: None. 


Example: (Request a "PD" list for user currently lojjzed-on, 
the “signat character” for the Server System's 
SMCS is assumed to be "8".) 


Input: <--= $PD =/= 


Reply: --- PO= "TESTER" 
PD= "OPENS" 


Notes: None. 


eeenreaeneseeene 66 ee 


oe “xK>Z <XX> 


e#eaeeGeeenseenseervea 
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Section III Commands (Revision "a"™) 


System SPO/Program Commands 


The following SYCOM commands are restricted to entry from either 
the system SPO or a special aoplication program. These commands 
are generally of the type used by a system operator to control 
functions relevant onty to operation of the system. They are 
generally functions a terminat us2r cannot Logically direct 
Without current knowledge as to the state of the system and its 
peripherals. By enforcing this restrictions the system is assured 
that control is at the system level and not at aterminat level. 


Program command input does not require the command string to be 
prefixed with SYCOM's “job number"™ and an “AX". Command input 
from a program should be tn the Same format as command indut froa 
terminals. 


‘ 
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Section III 


CL Command 


| 


Function: 


syntax: 


Semantics: 


Default: 


Example i: 
Input: <«<-- 


Reptys --- 


Example 2: 


Inputs <-- 


Reply: --- 


Notes; 


Commands CReviston a”) 


The .CL command is used to “clear” a peripharal 
device in the event the device becomes inoperable 
when receiving a data file. It clears Cdiscards) 
the buffers assoctated with the specified device 
and the receiving process is terminated. 


eCL <udi> 2 


udi = the Unit Device Identifier is restricted to 
one of the following mnemonic codes: 


LP 
cP 


Line Printer 
Card Punch 


Mo 


None: 


(Clear the Line printer because its down.) 

<sycom job #> AX.CL LP<etx> 

(no response) 

(Clear the card punch because there is no need toa 
continue. ) 

<sycom job #> AX.CL CP<etx> 


(no response) 


None « 


CL oe 


#epanaeeseseeseaeneana 
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Section III Commands (Revision “a™) 


«CP Command 


eh a et a TE SUD OD a 


Function: The purpose of this command is to inforan the User 
System that the systems Card Punch has fatten into 
a “not ready" statee SYCOM in turn informs the 
Server System Cif such connection 1s established) 
of this hardware deficiency condition. The Server 
System would “suspend” transmitting any card punch 
data stream messagess if it was in this process. 


It is a responsibility of the User System operator 
to inform SYCOM Cvia the appropriate command) when 
the card punch is again "ready™ to recetve output 
(see notes below). 


Syntax: ~CP NR 2 

Semantics: NR = Not Ready 

Default: None. 

Example: CInform SYCOM that the Card Punch 1s not ready.) 


Inputs -"= <sycom job &> AX CP NKR<etx> 


Reply: --- (no response) 


Notes: 1. To inform SYCOM that the "card punch®™ is now 
ready to receive output data»e the *.RY CP"™ is 
provided. 


2- If the card punch has become “inoperative» 
then the ".5V CP" command is more appropriate. 


ee seaeasceanscoaev eo 8 @ 


° cP * 


een @en eae eee na ee 
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Section III Commands (Revision "a"™) 


eODEBUG Command 


an eS a ee nc ee ee 
ne wD ee eee oe eee ee) ae 


Function: The “"DEBUG™ command provides the facilities for a 
printer trace of all data messages read or written 
by SYCOM. The "ON" option will inittate the DEBUG 
printer tracinge the “OFF™ option will terminate 
tracing» and when no ootion is specified a request 
for the current status of the DEBUG facility is 


assumed. 
Synt ax: eDEBUG <default option> 4 
ON 
OFF 
pn? 
Semantics: Self explicit. 
Default: If no option is specified or the option is tnvatid>» 


(not ON or OFF) a “status request™ 1s assumed. 


Example Ls (Turn printer debugging “ON for alt I/0 messages.) 


Input: ="- <sycom job #> AX.DESUG ON<et x> 


Reply: --~ DEBUG TURNED ON 


Example 2: CObtain current DEBUG status.) 
Input: ="" <sycom job #> AX.DEBUG<etx> 


Reply: =-" DEBUG ON 


Example 33 (Turn debugging OFF.) 


Input: =-- <sycom job #> AX.DESUG OFF <etx> 


Reply: ~="- DEBUG TURNED OFF 


Notes: None. 


. DEBUG . 


@*seenenoaeoeoaevwevene 
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Section JIT Commands | (Revision "a") 


eEOJ Command 


ie Oe ee ee eee ees 
oe me ee ee ge ee ae ee Pe eee 


Function: The ".E0J" command provides the capability for an 
orderly shutdown of SYCOM. Any further comaands 
are prevented (by rejection) from being processed. 
A message ("PLEASE SIGN OFF") 5 broadcast to atl 
terminals currently “logged=on" to SYCOM. A “close 
message” is sent to the other system's SYCOMW after 
the completion of any in-process file transfers and 
when there are no longer any terminats siqned-on to 
SYCOM. The SYCOM program then sends a "disconnect 
message™ to the Network Controller and goes to 
“"end-of-job". 


Syntax: eEOJS 2 

Semantics? None to euee aps 

Default: None. 

Examples CEntertng the command to shutdown SYCOM.) 


Inputs -"- <sycom job #> AX .EQJ<etx> 


Replys =-- PLEASE SIGN OFF 
we~ EGJ INITIATED 
wen SYCOM NOW OFFLINE 


Note: ALt file transfers which are scheduled to occur 
(queued) are permitted to transpire. 


ie FOU .. 


@eaeneo@oeoao Benen aee 
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Sectton III Commands ; (Revision %a"™) 


eLOG Command 


de 
ee ee ee ee 


Functions: The purpose of this command ts to display counts of 

specific data communication line errors and certain 
message transmission statistics. These counter are 
“not":zeroed out after they are disptayed. The Log 
treet is oroduced when these counters Cidentifiers 
included) are orinted in the "DEBUG trase™ Listing 
Cif the DEBUG option was "IN"). 


Syntax: | eLOG 2% 

Semantics: . None. 

Default: None. 

Example: (Request a display of the status counters.) 


Input: --- <sycom job #> AX.LOS<etx> 


Replys “=-- TIMEOUT = <count>-e 
BREAK = <count>» 
END“OF “BUFFER = <count>» e 
LOSS“GF-DSR = <count>» 
LOSS“QF7CARRIER = <count>» 
PARITY = <count>» 
BUFFER OVERFLOW = <sount>», 
MEMORY PARITY = <count>» 
NUMBER OF BYTES READ = <numoer> IN <count> RECEIVES 
NUMBER GF BYTES SENT <number> IN <count> TRANSMIS 


él a 
| me  ecewed 
Note: Expect the above reply message to be displayed as a 


single message string. 


° LOG . 


eenveceeeseeenveneeea 
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Section III Commands (Revision "a"™) 


eLP Command 


ae Om ee ee ee oe ee 
a ee ee ew ee ee 


Function: The purpose of this command is to inform the User 
System SYCOM that the Line printer has become “not 
ready™. SYCOM in turn informs the Server Systea of 
this temporary condition. The Server System then 
suspends transnitting of the line printer data 
stream messages until notified to resume by the 
User System's SYCOM. 


It is the responsibility of the User Systems 
operator to inform SYCOM when the line printer is 
again ready to recetve output data (see notes). 


Syntax: »LP NR x 

Semantics: NR = Not Ready 

Default: None. 

Example: (Inform SYCOM of a "not ready" Line Printer.) 


Inputs --"- <sycom job #> AX.LP NR<etx> 


Replys --7™ (no response) 


Notes: 1. To inform SYCOM when the line printer is ready 
to accept output datare the *".RY LP™ comnand is 
provided. . : 


Ce If the Line printer has become "inoperative™,» 
then the command “.SV LP” is more appropriate. 


3. This command is only relevant to RJE functions. 
In particulars when the line printer ts in use 
printing a RJE printer backup file. 


. LP. 
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eOFFLINE Commana 
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Function: The pucpose of the ".OFFLINE"™ command is to inform 
a Server System that the User System is going to 
“break” the existing connectton and go tnto standby 
modes waiting for the Server Systen to catl back. 
This command can be used for etther a "switched" or 
"non=switched" lina connection. Since the Network 
Controlier actually performs this action Cupon 
“S¥YCOM directive)e it then continuousty monitors the 
“data set ready™ signal. When this signal comes 
“true"™» the Network Controller re-establishes the 
connection with the system and normal operations 
then resume. 


Syntax: -OFFLINE 2Z 


Semantics: None. 
Default: None. 
Example: 


Inputs -"- <sycom job #@> AX.OFFLINE<etx> 
Reply: --- OFFLINE INITIATED 
m-- €8SYCUM NOW OFFLINE 


Notes: None. 


eee@agevevwveeweesa 


“& OFFLINE . 


eweaeeneeeoeeaeene eee ee 
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«ONLINE Cestablishment) Command 
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Function: The purpose of this command ts to cause the Network 
Controller to attempt to re-establish the line 
connection to the Server System. Upon satisfactory 
completion of this task» a response message is 
displayed (see example below). 


This command may be used in conjunction with the 
retry function. fhe error message “RETKIES“UP" 15 
displayed when the current message buffer being 
sent to the Server System #13 not b2ing received. 
By entering this command,r the message buffer being 
sent is discarded and an attempt is made to re- 
establish the line connection. 


Syntax: eONLINE 2% 
Semantics: None. 
Default: None. 
Example: 


Input: --- <sycom job #¢>» AX.-GN_-INE<etx> 


Reply: 77" “ONLINE™ INITIATED 
worm SYCOM NOW ONLINE to REMOTE HOST 


Notess None. 


@#eeneopo ogoeeosoaenenee 


° ONLINE . 


eose¢eqeeoweoeesveeeceee 
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ePHONE. Command 


eM Re Mee Maarten Menara Mannedipeeediher-alibtmnallpned 
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Function: The PHONE command is used to either “establish” a 
phone number to be used for the diat-out to the 
predefined Server System or to display an existing 
number. The automatic dial-out Cwith an Auto Catt 
Unit) to a specific Server System requires 3 phone 
number» hence the n2ed for the conmand. 


Syntax: «PHONE <phone numbear> Z% 
<null ootion> 


vod 
— 


the phone number of a target Server 


Semantics: phone number = 
SySt2me. 
null option = no option specified. 
= = clears existing phone number. 
Default: The omission of a valid phone number in the command 


string causes any existing phone number previousty 
entered to be "*disolayed"™. 


Exarmple:i: CEstablish the auto diat phone number of a specific 
Server System.) 


Input: s-—~ <sycom job #> AX.~PHONE 1°805~-964~-6881<etx> 


Reply: «-" PHONE NUMBER = 14895"964N688 1 


Note: If an autocdial unit its supplied» the specified 
phone number is used the next time diat-out is 
initiated to establish a connection to a Server 
System. (CDial~out is automatically initiated by 
the ".QNLINE”™ command.) 


e PHONE a 
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Function: 


Syntax: 


Semantics: 


Defaults 


Example: 


Input: 


Reoly: --- 


Notes: 


30 Nov 1978 
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(Reviston "a"™). 


This command allows a user to set a maximum number 
of méssage buffers that can he queued at any one 
time between SY[O0M and the Network Controlter. The 
value range for this parameter 1s 4& thru 15. (For a 
description on the use of this parameter see the 
writeup on “Queue Depth Control" in Section II.) 


-QS=<queue size> 2% 


queuve size = ai or 2 digit integer representing 
the new Queue Depth Limit. A suggested 
value for this parameter would be 10 


messag2 buffers. 
None. 


(Change the queue size to 10.) 
<sycom job #> AX.Q5=10<etx> 


QUEUE SIZE CHANGED TO 190 


A specified value outside the defined value range 
produces an error response. 


“ie as . 


eee eeseeoseeaeeaene cue 
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Function: The *".READ™ command causes SYCOM to open an tnput 
card fite and commence transmitting those card data 
images to the Server Systems providing a connection 
has been established. When end~of-file is reachedr 
the file is ctiosed automatically. 


This command is only processed when the User System 
is properly logged~on to a Server System which is 
defined as a “host”. (€1t is possible to override 
this feature by using the ™.RYCR™ command instead.) 


Syntax: «READ Fale name (rsx) 


Semantics: Nonee 
Default: Assumes the itnput card file ts tabeled "RJE/CARDS". 


Examples (Start transmission of an RJSJE card data file.) 
Input: *-" <sycom job #> AX.READ<et x> 


Reply: --" CARD READER OPENED 
ams=~. CARD READER CLOSED 


Note: An input card file is defined to be any group of 
cards with the first card in the dack containing 
"<I> STREAM RJE/SCAROS™ and the last card containing 
"<I> TERMINATE RJE/SCARDS"™. (The <I> symbol: 
reoresents an invalid character in coluan 1 as 
required for MCP control. 


dus {lis Pvscess Ne “what : Command vill 
7 % ( peor 
veflert repel Pe, open ghe-brs 4 {a (a+ 


° READ . 


@eeeaaneeenm@eseeve 0 8 
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eRESTART Command 
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Function: 
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This command is onty valid from the system SPO. Its 
purpose is to cause SYCOM recinitialize itselfe 
break the connection to a host Server Systea» flush 
the "PUT" queue and to go into “standby™ states 
waiting for a connection to be initiated» either by 


Syntax: 


Semantics: 


Default: 


Examples 


Input? “=--. 


Reply: --- 


Notes: 


entry of the *.QNLINE”"” command or with a "connect" 
controt message from a remote system. 


eRESTART rn | 


we ] 


None. 
Nonee 


(Cause SYCOM to disconnect and standby.) 
eRESTART<etx> 


SYCOM NOW OFFLINE 


None. 


° RESTART . 


eeseeseeeaeaeeaenseeteea2 ve 
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eRY Cready) Command 


i ee mY eA om ER OG ee eee 


eee 


Function: This. command is used to inform SYCOM that the 
specified peripheral device is currently ready to 
send/receive data. SYCOM in turn takes the 
appropriate action to advise the Server Systen. 


Syntax? eRVY <udi> 2% 


Semantics: udi = the Unit Device Identifier ts restricted to 
one of the following anemonic codes: 


CR = Card Reader 
cP = Card Punch. 
LP = Line Printer 
Default: There are no defaults. 
Example: (Ready the Line printer.) 


Input: -"- <sycom job #> AX.~RY LP<etx> 


Reply: --- (no response) 


Notes: None. 


° RY . 


g@eese @#acece#eoetseeeee# 
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«SIZE Command 
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Function: This command attows the system operator to set the 
maximum message buffer size for transmitting and 
receiving purposes. SYCOM then informs the Server 
System of this change with a special system control 
type message. 


Syntax: »SIZE=<buffer size> x 


Semantics: buffer size = is a three digit integer with a value 
limited to a range of fron "078" thru 
"400" bytes. 


Default: Nonee 
Examples (Reduce the send/receive message block buffer size 
to 329 characters.) 
Input: **= <sycom job #> AX.SIZE=320<etx> 
Reply: --- “".SIZE" INITIATED 


Note: This command applies only to the RJE functions of 
the SYCOM system. 


Ae SIZE o 


esewseeosvseneeoeweoe 4 
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«STOP Command | { 
Function: This command provides the ability for an tamediate 


shutdown of SYCOM. No further input messages are 
accepted as SYCOM goes to “end-tof-job" immediately. 
Terminals are not logged-offs» virtual terminals are 
not disconnectedr nor 15 an tnter-system connection 
gracefully disconnected. 


Syntax: ~STUP &% 

Semantics: None to specify. 

Default: None. 

Example: CEntering the immediate shutdown coamand. ) 
Input: --" <sycom job #> AX.STIP<etx> . i 
Replys --- SYCOM =<job #> EOQJ. TIME = 16221°55.1 { 


° STOP . 1 


*@@eeeaeen8heeeseeense 
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2SV Command | 
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Function: This command directs the User System to inform the 
Server System to cease transmitting the card punch 
or line printer data stream and to “Save™ the 
entire file at the Server System. The command 
permanently inhibits the transmission of any 
further card punch or Line printer data str2ams 
until notified by the User System (see notes). 


Syntax: eoSV <udi> 2% 


Semantics: udi = the Unit Device Identifier is limited to one 
of the following mnemonic codes: 


CP = Card Punch 

LP = Line Printer 
Defaults: None. 
Examples (Terminate the output to the Card Punch.) 


Input? --- <sycom job #> AK.SV CP<etx> 


Reply: ~-~- (no response) 


Notes: 1. To rerestablish the card punch or tine printer 
output data streams the command *.RY CP® Cfor 
the card punch) or ™.RY LP* Cfor the printer) 
must be used. This is used to inform the Server 
System to start sending any card punch or tine 
printer data streams that are available for 
transmission. 


2- Alt card punch and Line printer data streams 
start at the beginning of the file. 


° SV. 


eeaenmeaeeneeneeéeses 
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eTRACE Command 


Function: 


Syntax: 


Semantics: 


Defauits 


Example 1: 
Input: -~- 


Reply: --- 


Example 25 
Input: =-- 


Reply: =<<-<- 


Exampte 3: 
Inputs --- 


Reply: «7-7 


Notes: 


III Commands 
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The TRACE command provides facilities for "tracing" 
att -SYCOM input/outaut messages. The command is 
only valid if entered from the system SPO and the 
following options apply? "ON" starts disk tracing, 
"OFF™ stops tracing and with no option speci fied» 
the current “trace status” ts returned. 


TRACE <null option> 2 : 


ON 
OFF 


Self explicit. 


If no option ts specified» a “status™ request is 
assumed. 

(Start 1/0 message tracing.) 

eTRACE ON<etx> 


DISK TRACE TURNED ON 


CObtain current TRACE status.) 
eTRACE<etx> 


TRACE ON 4 * 19 * 10 = 400 RECORDS 


(Turn tracing OFF.) 
«TRACE OFF <etx> 


DISK TRACE TURNED OFF 
None. 


° TRACE . 


*#*@eneneveeeeseenese 
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i {. Local System |! Remote System 1 
I i Input ' Process { 
{ ee Pete ew mm meneame owe mamene |} 
{ Command ' No SMCS € SMCS ! Source { No SMCS # SMCS 1 
| aed teehee ietatete tated Relkekale kate ketedd tekekebelelall tolakelatekelelel tekedelabaketdetel teletatateted 
1 { | 1 t i j 
' ABORT { yes tyes &t TSP 1 no. ' no 1 
1 “I BYE i yes ! yes & TSP { no 1 no t 
{6 6U { yes tyes ¢ ™ SP { no i no j 
t CONNECT 1 yes l yes t TSP j no t{ yes 1 
§ COPY ] yes ! yes ¢ USP t no ! no | 
, enraged” 
t CP 1 yes f yes i SP ! no { no i 
1 -ODEBUG I yes fyes | SP ] no ! no 1 
i e DISCONNECT | yes tyes ¢t& JSP { no f yes f 
i .£G . { yes tl yes | SP 1 no { no i 
ft FETCH { yes ! yes ' ose 1 yes f yes 1 
{ .LIST i yes {yes t Sp i no { no { 
‘ .LoG- t yes {! yes 1 SP 1 no { no 1 
i LP ] yes if yes | SP 1 no { no { 
! «OFFLINE i] yes {f yes { SP ( no 1 no { 
{ .ONLINE i yes fyes 1 SP i no § no 1 
§ «PHONE i yes ! yes 1 SP t no i ono i 
! .PuT ! yes ! yes 1 TSP { no 1 no ' 
1 oo { yes tyes 1 SP | no i no i 
! READ i yes tyes 1 SP j no i no { 
! eRESTART { yes ! yes SP { no I no i 
I RY | yes lyes | SP { no { no { 
1 «SIZE { yes { yes 4 SP i no ! no t 
{ .STOP | yes {t yes 1 SP t no { no i 
t SV i yes ft yes 1 SP ] no { no | 
t eTRACE ( yes ft yes f SP { no { no | 
f USER { yes f yes f JSP { no if no! 
1! WHAT ! yes ¢« yes 1 TSP i no ino t 
t «<User SMCS> | no }oyes 1 ‘Tsp | no ' no | 
{ «7<User MCP> i no |! yes { TSP i no { no ( 
{ <K><Server SMCS> 1 no { no { TSP ! no { yes 1 
! <X>Z<Server MCP> | no I no 1 TSP i no {t yes | 
1 i i 


Note: The above commands are restricted to entry from the source 


indicated in tne table above. 


Legend: J = Terminat 


beeen rene ne ree 
S = SPO 
P = Progran 


Table TIIIv1l: Command Input Summar:y 


ble 
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SECTION IV 


OPERATING PROCEDURES 


INTROOUCTION 


Cece ealeee dhe deatibecAaaadhen, Ahadieactiiend 
2 en a a ee aU pe on 


This section provides system and terminal operating procedures 
used for the operation of a SYCOM system with and without tocat 
terminalss and/or in conjunction with the Supervisory Message 
Control System (SMCS). System opzrating procedures are slanted 
toward operation of SYCOM for the purnose of Remote Job Entry 
CRJE) tyne functions and the associated system control functions. 
These procedures present all aspects of SYCOM operations from 
initialization thru controlled shutdown. 


Local terminal operationat procedures are separated into two (2) 
categories; terminals under SYCOM control and terminats under the 
control of the SMCS. These procedures provide coverage of alt 
terminat operations within the scooe of SYCOM) from sign-on to 
Ssignvmoff. Actual input/output message text is used in th? 
examptes to provide a feel for the ease of operation and what can 
be expected by a user of the sySten. 


SYSTEM OPERATING PROCEDURES 


Leader dae ancllhnnee diene Einar Elh nadie A pA cael nal eae Bgeedlomn dl ain Alana anarchy atime Ever Apa Bay alprertaaae ea 
ee ee ee ee ed 


The system operational procedures presented here are intended to 
provide a User System operator with sufficient tinformation for 
operation of an interactive system using SYCOM. Operation of the 
associated Network Controller is briefly discussed. In additions 
suggestions on the use of certatn basic SYCOM commands and their 
options are exemolified. 
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PRELIMINARY PROCEDURES 


Before the SYCOM system is executed» the user needs to be aware 
of a few system variables that must be considered. First there 
are “program switches™ which are used to invoke certain optional 
features. Second there is the “parameters” file which is used to 
maintain SYCOMN's variable control functions and processing 
attributes. Each of these subjects in covered in turn starting 
with the program switches. 


Program Switches 


2 28 TE CoD a8 it OF ae a & 68 as ae 


Program Switch 0 serves to establish “auditing” at BOJ times a 
value of 10 accomplishes this tasks anything elsSer no dice. 


Program Switch 1 serves to instrust SYCOM to utifize the 6.0 disk 
file open capabilitiess open on-behatf-of in particular. 


Program itch— irect Sa ee eee f data lines 
“ent d in fhe BUG ELibe“for a ingTe audtt entrys oy 


Preparation of Parameters Card File 


Because SYCOM automatically uses an existing “parameters" file 
from diskre to enter changes to any existing fite requires that 
the current “"SYCOM/PARAMETERS"™ file be removed prior to program 
execution. This causes SYCUM to effect the process which creates 
anew parameters file based ons 1) a predetermined set of defauit 
parameters and 2) any parameters entered Supersede the associated 
default parameter. 


These parameters can be entered either from the card reader or 
the SPO. Howevere an important point to noter SYCOM will first 
attempt to accept parameters from a "card" file and failing to 
find this files enters the mode whereby tt accepts parameters 
from the system SPO. Therefore, if card oarameter input is to be 
useds the card reader “must be readied” prior to execution. 


R 


a a 
Ss 
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A simple way to create a paraneters file is to punch a card decks 
providing the target system has a card reader tn its hardware 
configuration. The external name of this parameters card file is 
"CARDS". Folloring is an example of a SYCOM system card file: 
(The <I> in the example below reoresents an “invalid” character 
as required for MCP type commands. ) 

>) 2 


<I> DATA CARDS 
DEBUG 
BUFFER = 1000 


SYSTEMID = USER1 aX 


PROGRAM 
NOFS \D 
NOF TP 

WAIT 

TIMEQUTS = 25 

<I> END 


The above example shows “all"™ of the avatlable SYCOM parameters. 
Howevere in areal tife situations parameters are selected to fit 
the requirements of the individual system. Refer to the procedure 
"Entering the Parameters” of descriptions of these parameters. 


I€ the system does not have a card readers then the procedure 
“Entering The Parameters™ must be utilized "after" SYCOM has been 
executed. When SYCOM 1s ready to accept parameters from the SPO 
it is so indicated by the display of "ENTER SYCOM PARAMETERS". 
(Refer to "Execution of SYCOM"™ procedures. ) 


Setup MCP Program Name Tabte 


In order for SYCOM's Network Controtter to be automatically 
executed by the systems it is necessary to establish the identity 
of this Controller in the "MC? Program Name Table™. To do this is 
simpler enter the following MCP command: 


“-> CM C USEK/NC<etx> 
NETWORK CONTROLLER CHANGED FROM "" TO fPUSER/NC® 


The controtler name “SYCOM/NC"™ 15 of course a user optional name 
and is therefore onty representative. YVhe actual Controller name 
selected by the user would be substituted as required. 
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To verify that the correct Network Controlter I/0 is in the MCP 
Name Table ("C™ slot)» the following MCP command can be entered: 


“=> WWC<et x> 
C = "USER/NC* 


Assigning Program Priorities ~~ 


For ceptimum system responses» it ts necessary that the system's 
Network Controller and SYCOM run at a "high" priority. Therefore» 
to ensure that the MCP automatically executes these orograms at 
their optimum priorities» the following MCP commands are used to 
permanently assign a priority of *15"% to the Network Controller 
and 2a priority of "12" to SYCOMS: 


“-> MO USER/NC PR 15<etx> 
WUSER/NC™ MODIFIED 


--> #0 SYCOM PR 12<etx> 
"SYCUM"™ MODIFIED 


EXECUTION OF SYCOM * WITHOUT SMCS 


To use the SYCOM system without the benefit of a SMCS» the system 
operator simply enters the execute SYCOM command as Shown oelonw. 
The MCP automatically executes the associated Network Controtter 
program Cproviding one 1s in the "C"™ stot of the MCP Name Table) 
when the first remote file onen is initiatéd for the controtler. 
‘Both SYCOM and the Network Controller should be run at a oriority 
which ensure adequate response tines to the user of the system 
(see suggested priority values below). 


It is the option of the user whether or not SYCOM is executed 
With a “privileged usercode". If accessing of usercode files is 


required> then_it_must_be executed with a privileged userec odes 
otherwise it 1s executed as shown belon. 


=-> EX SYCOM<etx> 


SYCOM =<job #> B05. PP=12,+ MP=12 TIME = 08214251.2 


ae 
an 
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During the beginning of the initialization phase if SYCOM cannot 
locate the “SYCOM/PARAMETERS” file on disks tt attempts to obtain 
new parameters from the card reader C™CARDS"™ filed. Should the 
card reader be "not ready" or if there is no card readere then 
SYCOM will lapse into the mode of accepting new parameters from 
the SPO. When SYCOM 15 in this mnoode the following messages are 
displayed on the SPQ: 


% SYCOM =<job #> ENTER SYCOM PARAMETERS 
SYCOM =<jot #> ACCEPT. 


The system operator can then enter the appropriate parameters to 
alter the System's “default oarameters”™ (refer to Appendix Ge 
"Parameters Fite Attributes"). The entry procedure is presented 
with "Entering The Parameters™ in this section.» Although the 
"SYSTEMIO™ parameter 5 not requireds in some instancesr it is 
Strongly suagested that a representative “system identifier” be 
entered with the parameters at this time. 


Once this file is established on disk» it need not be recreated 
untess it is Lost or requires changes. Changes to the file can 
fade using either of the two methods identified. Howeversr agains 
it 1S necessary to “remove” the existing parameters file from 
disk. Additionally» this requires SYCOM to be shutdown and 
re~executed if it is currently cunnings else all is in order. 


When SYCOM opens its Remote FilesSe the MCP knows whether or not a 
Network Controller is cunning and takes the appropriate action. 
That is» if a Controller is runningr then the renote file opens 
take place and the system becomes operational. If a Controtler is 
"not™ currently runninge then tf the Controtler's name is in the 
"Cc" stot of the MCP Program Name Jabler the MCP automatically 
executes the named Controttler program and the fottowing messages 
are displayed at the SPO: 


EX SYCOM/NC PT> 
SYCOM/NC =<job #> B8OJ. PP=1L5»5 MP=15 TIME = 08215:08.7 


If there is no Controtter name entered in the MCP Program Name 
Tabler then the following message ts disotayed: 


REMOTE FILE “TERMINALS™ NEEDS A CONTROLLER 
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The system operator must then execute the appropriate Network 
Controlter by entering the following command: 
“—-> EX SYCOM/NC<etx> 


SYCOM/NC =<job #> BOJ. PP=L5» MP=15 TIME = 08:16:91.2 


The MCP displays the above "BOJ" message» permits the Remote File 
opens to occuc and the system is operational. 


Further on during the initialization phase» if Program Switch 3 
is set to a value of "3"%» tne following message is displayed on 
the system SPQ: 


2 SYCOM =<job #> RUN DAY = THURSDAY 09 NOV 7B AT 08203231 


Upon completion of SYCOM'sS initialization phase and a successful 
connection established to a default Server System» the following 
messages will be displayed on the User SPQ: . 


% SYCOM =<job #> keke SYCOM VII.004 C27 OCT 78 13205) kane 
% SYCOH =<job #> SYCOM NOW ONLINE TO REMOTE HOST = SERVER1 
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EXECUTION OF SYCOM «* WITH SMCS 


When SYCOM runs in conjunction with the SNCS» it is automatically 
executed by SMCS thru its “job spawning” facility. This occurs 
when the "first™ terminal user “"SIGNS~ON" or "PASS 's* to SYCOM 
from a local terminal. Therefore» the system operator must not 
execute SYCOM from the system SPOs else SMCS just zion executes 
another copy of SYCOM which causes a few operationat problems. 


Prior to SYCOMts operation under the SMCS» an entry must be made 


in the *“SMCS/J0B8S" file for SYCOM. A sample entry ts inctuded in 


the “SMCS Software Qoerational Guide" for this purpose under the 
heading “Editing The JOBS File™. 


If ducing the initialization phas25 SYCOM cannot locate the file 
"SYCOM/PARAMETERS™» tt attempts to obtain new parameters fron the 
card reader (C*CAROS" file). Should this card file not be present 
or if there is no card readers than SYCOM commences to accept new 
parameters input from the SPO. fo signat the system operator of 
this cequiremente the following messages are displayed: 


%Z SYCOM =<job #> ENTER SYCOM PARAMETERS 
SYCOM =<job #> ACCEPT. 


The system operator must then enter the appropriate parameters to. 


override the system's “default parameters" (refer to Appendix Gr 
"Parameters File Attributes"). Tne parameter entry procedure is 
presented with "Entering The Parameters"s this section. Although 
the parameter "SYSTEMID™ is not requireds for some instancese it 
is strongly suggested that a representative "system identifier" 
be entered with the parameters at this time. 


Also during the initialization phaser if Program Switch 3 is set 
to the value "3", than the following SPO message is dtsplayed: 


% SYCOM =<job #> RUN DAY = THURSDAY 09 NOV 78 AT 08303331 


Upon completion of initiatization and the successful connection 
to a default Server Systems the following messages are displayed 
on the User SPO: 


% SYCOM =<job #¢> #e&ee SYCOM VIT.0-4 (27 OCT 78 13295) wea 
% SYCON =<job #> SYCOM NOW ONLINE TO REWHUTE-HOST = SERVER 
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COMMON SYSTEM OPERATIONS 


Sense eae gcet SB RTF ORM Owe aan ene Bm 


Once SYCOM has been executed» froa either the SPD or spawned by 
the SMCS» most operating procedures are common to both modes of 
operation. These common operating procedures are oriented to SPO 
input in the form of SYCOM parameters» SYCOM commands» and MCP 
directives. Following then are the common operating procedures, 
presented in the sequence they are most Likely to occurs under 
individual headings. 


SHCS Signal Characters 


In order for a SYCOMH systems network to function affectivaty» it 
is a requirement that the SMCS “signal character” for each system 
in the network to Ce a different character. This can be easily 
accomplished by mutual agreement when the SYCOM syste network is 
designed. Each system's SMCS should have a specific character 
which is made known to all system uSers.e. Obviously» tf the SMCS 
is not utilizeds this is not necessary. : 


If during actual system operations it is found that a SMCS signal 
character 1s undesirable for any reasons it can be changed while 
online. This can be accomplished by entering a "signal character 
change command" from either a tocal or remote source. For actual 
details» refer to the "SMCS Software Operational suide"™. 


Entering the Parameters 


The parameter definitions listed below can be entered to SYCOM 
from the system SPO. To do sor they must be entered with one 
line using the following “Accent” process: 


“-> <sycom job #> AX <parameter keyword> (=<value>] 
(<parameter keyword> (C=<value>]...-J]J <etx> 


Each parameter is vatidated and the system operator ts informed 
of any illegal parameters encountered during the parsing of the 
parameter data. 
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DEBUG parameter 


This parameter indicates that the printer tracing mechanism is to 
be utilized to produce a record of SYCOM's I[/0 message activity. 
(The default is “*no printer trace".) 


Syntax: DEBUG 


BUFFER parameter 


This parameter defines the size» in bytes»r of the used in SYCON 
communications with the other system. The buffer size should be 
large enough to handle the largest message» and possibly achieve 
a blocking factor for multiples of a record. 


Syntax: BUFFER = <integer> 


The default buffer size is 4090 and the maximum allowable size is 
1950 bytes. (CThis parameter directly retates to file transfer 
buffer size and not RJE buffer size.) Be advised however» that 
this buffer size must be equal to or greater than the maximum 
record size to be transferred multiplied by 2» plus 23 needed for 
non=data record transtations. 


SYSTEMID parameter 


This parameter is used to specify the name of the User System. 
A systemeid can he comprised of from one to seventeen characters. 


Syntax: SYSTEMID = <system-jd> Ce.gee USERL) 


PROGRAM parameter 


This parameter is specified when SYCOM is to perform program-ta- 
SYCOM functions. The “record size” parameter limits the maximum 
length of these messages. (This paraneter defaults to "no" 
Program=totSYCOM input permitted.) 


Syntax: PROGRAM 
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TIMEOUTS parameter 


This parameter is used to establish an “*interval"™ for the display 
of “NUMBER OF TIMEOUTS = 25" error: messages on the system SPO. A 
value of "0" inhibits the message display entirety. OGther values 
cause the message to be displayed when the timeout count reaches 


the specified value. 
T RACE - apueren 


WAIT parameter qUaNS ov 


Syntax: TIMEOUTS = SUA Oe? 


This parameter is used to prevent SYCOM from going to “end-of-job 
when it receives a "disconnect message™. SYCOM will disconnect 
and lapse into a “offline/idite™ state. 


Syntax: WAIT | 


NOFS parameter 


neem em Rom th a we me ee a om 


SYCOM will not send a “FS1" or “F52" Cfile separator) to thea 
other system when sending card images (relevant to 7.0 RJE). 


Syntax: NOFS i 


NORTE pat anet er 


This parameter inhibits File Transfers. 


Syntax: NOFTP 
ETX parameter 
Entering an ETX in the parameter string terminates the parameter 


Input procesSe 


Syntax: <sycom job #> AX <parameter string> <etx> 1 
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The system operator is permitted to communicate with SYCOM using 
By entering certain commands Cexamples 
1s also permitted to communicate with 


the MCP 
below). 


"AX" facility 
the operator 


application programs 


terminal” 


as fotlowss SPO input 
are output reply messages: 


w=) 


ow, 


o=-> 


mony 


a> 


.d 


* 


facility of SYCOM. 


na Server Systems thru the “virtual 


is Flagged with “*-=-> 


<sycom job #> AX.WHAT<etx> 


SYCGM ONLINES IDLE 
THIS STATION NOT CONNECTED Oe 


LOCAL HOST 


— 
— 


USERL» REMOTE HOST 


<sycom job #> AX.US MY/USER<etx> 


USER MY/USER LOGGED ON FO SYCOM 


<sycom job &> 
FILE DMPALL 
FILE DMPALL 
FILE OMPALL 


<sycom job #> 


FILE (MY)/#3152 START TRANSMISSION 


AXeFETCH DMP ALL <etx> 


START TRANSMISSION 
RECEIVED | 
END TRANSMISSION 


wv 


—_= 


A typical command session might go 


and indented lines 


SERVERL 


AXePUT OCMY)/#3152 ONO LIST)<etx> 


FILE (MY9/4#3152 END TRANSMISSION 


<sycom job #> AX.CONNECT<atx> 


CONNECT INITIATED 
CUNNECT COMPLETED 


B1800/81700 SMCS MARK VITI.0.65D0D C10/31/78 17:02) 
CMY) LOGGED ON AT 14:2:19°26.5 11/08/78 

YOU ARE AT STATION 13 CVirtuat) 

News: This 1s Serveri1 SMCS» may J be of hetp? 


<sycom job &> AX.~WHAT<etx> 


SYCOM ONLINE? TOLE 
THIS STATION CONNECTED USERCODE 


LOCAL HOST 


USERL» REMOTE HOST 


MY» 
SERVERL 
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“-> <sycom job #> AXZ EX DISK/COPY SW9 LFPR 9<etx> 


DISK/COPY =<job #> 30J. PP=9%» MP=9 TIME = 12231°54.3 
% DISK/COPY =<job #> ENTER SOURCE AND DESTINATION 
DISK/COPY =<job #> ACCEPT. 


--> <¢sycom job #> AXZ <disk/copy job #>AX C(MYI/CODE TEST<etx> 


DISK/COPY =<job #> ACCEPT. 


“*> <sycom job #> AXZ <disk/copy job #>AX <etx> 


I 


DISK/COPY =<job 4> EOS. TIME 12:35:33.6 


“=> <sycom job #> AX.-DISCONNECT<etx> 
STATION DISCONNECTED 

“=> <sycom job #> AX.FETCH TEST<etx> 
FILE TEST START TRANSMISSION 
FILE TEST RECEIVED - 
FILE TEST END TRANSMISSION 


“-> <sycom job #> AX.BYE<etx> 


ArBOD BYE: SYCOM CMY) LOGGED OFF at 12:36:11.8 


Systematic SYCOM Shutdown 


When SYCOM is running as a self-sustaining entity Cwithout the 
SMCS)5 the ™.E0J" command provides the means by which an orderly 


shutdown can occure Once this command has Geen entered» atittl 
subsequent commands entered are rejected. An appropriate "close 
message” 15 sent to the other SYCOM after the completion of ait 
in-process file transfers. SYCOM then sends a “disconnect 
message" to the Network Controttler and goes to "“end-of-jot"e To 
initiate an orderly shutdown of SYCOMe the system operator aust 
enter the following: 


“-> <€sycom job #> AX.EQJ<etx> 


The follonxing message is displayed timnaediately on the User SPQ. 


% SYCOM =<job #€> EQJ INTTFIATED 
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No further processing requests are accepted. Any file transfers 
queued to process are allowed to complete. At the point in time 
“when there 1s no tonger any SYCOM activitys SYCOM goes to “E0J". 
The standard MCP "“E0J message” is displayed for this action: 


SYCOM =<job #> EOS. TIME = 10221255.1 


When SYCOM is running in a self-sustaining environment and it is 
necessary to shutdown the system "immediately"s» then-the ™.STOP” 
command proviaes this means for termination. Upon entry of this 
commands» all in-process activity is aborted and allt scheduled 
events are purged. A “close message” is then sent to the other 
SYCOMs a “disconnect message™ sent to the Network Controllers» and 
the program goes to “end-of"job". The system operator enters the 
following to initiate the immediate shutdown of SYCOM: 


“==> <sycom job #> AX.STOP<etx> 
The following message is then displayed on the system SPO: 
SYCOM =<job #> EQJ. TIME = 15°221:55.1 


When SYCOM is CUNNing tin conjunction with the SMCS» the "STOP" 
command entered to the SMCS in turn causes SYCOM to be terminated 
automatically. When this occurs» the following message will be 
disptayed on the SPQ: 


SYCON =<job ¢> DEATH IN FAMILY.’ TIME 12:58:01.1 


A note of importance? If there are any requests queued for 
processings they are lost when SYCOM shuts down under these 
circurstances. : 
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Printing The TRACE File. 


The disk TRACE fia can te printed With and option to the oes 


commands ete ro PD QUS4 YCOM to stop processin ay 

ADDL CARS requests such as file’ transfers. This Gaeaaycntaue an 

be overcomhe by printing the fjte independent Ly using the sandard 
amp, 


system software utitity oro ae By following e below 
procedures eyther the "curent or the “previous” trgce file can 
be printed as ge \ . 

yf Y 


\ 


EX OMPALLZFY OUTP.FILE INV 27 PR Lo<etx> 


\ 
AT, <hob #> BOS. PP=105 ¥P%10 TIME = 10:33:231.4 
z DMP =@job #> ENTER SPEQ% SS 
DMPA. oN #> ACCEPT. | a 


® a” 
cdnpat jot #> AX CORY DS SYCOM/TRACE 132 4xetx> we 
A DMPALL =<job #2MENTER SPECS Ne 
f OMPALL =<job ¢> ‘etyPT. ok 
dmpaltl job #> AX <étx> ue x 
DMPALL =< j off #> EQJ. TIMP 1023425661 ON 


\ J ae 
f Eg 
The TRACE file cag” also be printed froms@ terminal. The above 
procedure can beffollowed but must however » be adapted to the 
type of terminal’ from which DMPALL js exectted. 


Because the disk trace file is maintatned in two tevelse previous 
CSYCOM/OLODTRACE) and current CSYCOM/TRACE)» either of which can 
be printed using the above procedure by supplying the appropriate 
file name in the "COPY" command striny. : 


ee ee a ee ee ee ee ee ee ee ee ee ee ee ee ee ee 
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Reactionary Hints and Pointers 


During the course of SYCOM op2grationse there are a few unusual 
System “conditions” which could occur. In order for the system 
operator to correctly respond to these conditionse there must be 
sufficient information availagyte. That information is provided 
here in the form of provtem descriptionse “hints™"» "pointers” 
and responses to these conditions. 7 : 


Ae When SYCGM apoears to be “hung ups» enter "<jobd #>WY™ at 
the system SPO. If the following message is disotayed: 


SYCOM =<job #> WAITING MAGNETIC TAPE <tape lLabel> 


then SYCOM has been autoaatically stopped waiting for 
the required magnetiz tapge to become availables at which 
time SYCUM operations witt automaticatty resume. 


This condition is resolved by the operator making a 
scratch magnetic tape available to.the system. 


Should the following message be displayed: 
SMCS =<job #@> WAITING QUEVE NOT FULL FOR WRITE 


then SYCUM has been automatically stopped from “uriting" 
any more messages into the Network Controller's tnput 
queue until it can successfully deliver at least one 
output message. 


If this condition does not resolve itself after some 
period of time €2 - 5 minutes)» the system must be 
brought down with the MC? “"QC*% command. CA syst2m 
includes the SMCS» Network Controller» CANDEr and any 
other program associated with the Network Controller.) 


Or if the foltowing message is displayed; after SYCQM 
has been just executed: 


SYCOM =<job #> EXECUTING 


Then the problem lies in the fact SYCOM is attemoting to 
establish a line connection to a remote system. It will 
continue in this cycle until either the connection has 

been established or the program D0Std. No input comnrands 
are entertained during this initial establishment cycle. 
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Be If the fotlowing message is displayed (by the MCP) on 


the system SPO during th2 tnttiakization phase: 
INSUFFICIENT DISK WHILE OPENING QUEVE-FILE "SYCOM* 


It means that there is not sufficient space on disk to 
open the "SYCOM/LINK.Q" queue. Affirmative action by the 
system operator would be to make available a sufficient 
amount of disk space Capproximately 2000 segments). 


If the following message is displayed after the system 
parameters have been entered and either file transfers 
or virtual station connections are to be entertained: 


AGE WARNING = NO "SYSTEMID™ #28# 


then to overcome this conditions the following procedure 
must be carried out: 


1) Enter the command "™.STG?P* 

2) Remove the "SYCOUM/PARAMETERS" file 

3) Restart SYCOM 

4) Rerenter the system parameters as required 


SYCOM Software Ooerational Guide 30 Nov 1978 
Company Confidential -rr-- Santa Sarbara Plant Page - 125 


Section IV Operating Procedures CRevision "a"™) 


TERMINAL PROCEDURES 


ee eee ee ee ee ce eee ee cee 
ee ee nee eo ee a eee oe 


In this sub-sectionr basic terminat operating prozsedures are 
provided in the form of examptes. For a SYCOM oriented system 
howevere terminals. may be owned by either SYCOM or the SMCS. 
Because of these possibilities and the associated imonlications»s 
specific operating procedures are included for both “SYCOM 
controlled” and "SMCS controlled” terminals. 


TERMINAL FUNCTIONS 


Terminal functions are those softuare features found in a TD820- 
and/or T0830 type Video Disptay Terminat (VDOT) devices. These 
terminal features would included such things as? tab stops» 
Lower/upoer caSe» scrolling» atc... These functions are fully 
described in the Supervisory Message Control System CSMCS) 
Software Gperationat Guide (see documentation reference). 


TERMINAL OPERATIONS CSYCOM CONTROLLED) 


Khen a tocat terminal is under the direct controt of SYCOM» it is 
also permanently "attached™ to it. Therefore» a terminal user has 
immediate access to SYCOM functions. A terminal can howevere be 
temporarily “attached"™ to either SYCOM or the SMCS in a Server 
System. Theu Server System's SMCS» the terminal can also be 
“attached” to an appropriate interactive application program in 
the Server Systema. The termtnal user is not Limited to just a 
few SMCS commandS»e a user may invoke any command which the SMCS 
has in its repertoires with the exception of those restricted to 
input from the SPO. , 


Exampte Interactive Terminal Session 


Terminals at this point are attached to the User Systems SYCOM. 

In order to utitize the SYCOM canoabilitiesr a terminat user need 

only enter the desired SYCOM commands. Among these SYCOM commands 
are ".CONNECT™ and "“.DISCONNECT™. These are used to gain access 

to any appropriate interactive application progran tn the Server 

System. The examples which fotlow exptore atl possible terminal 

connections as detailed in “Message Path Assignments”. 
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In the examples below» terminal input is identified by the flag 
wem>". All other Lines are reoly messages from the program to 
which tne terminal is currently inputting to. Fiest some basic 
local SYCOM commands are shown. ALL’ SYCOM commands are entered 
directly as exampled below: 


w~e> oe HHAT CUser SYCOM) 


SYCOM ONLINEs IDLE . 
THIS STATION NOT CONNECTED GERGOB-E—=—»--, 
OCAL HOST = USER + REMOTE HOST = SERVERI 


“=>  JPUT DMPALL (User SYCOM) 
FILE DMPALL START TRANSMISSION 


“~> WHAT CUser SYCOM) 
SYCOM ONLINE? O09 FILES QUEUVEDs SENDING DMPALLC47/85) 
THIS STATION NOT CONNECTED 8SfFCHDE ="F 
LOCAL HOST = USER» REMOTE HOST = SERVERI 
FILE OMPALL END TRANSMISSION 


“=> CONNECT . (Usar. SYCOM) 


CONNECT INITIATED 
CONNECT COMPLETED 


“~> = 6.WHAT . (User SYCOM) 
SYCOM ONLINE? IDLE 
THIS STATION CONNECTED WOERERTE = o> 
KLOCAL HOST = USERE+ REMOTE HOST = SERVER 


“=> JOBS | CServar SMCS) 


ACTIVE: 

SERVER/NC =<job #> PP=155 MP=15 
SMCS =<jot @€> PP=L3>» MP=14 
SERVER/SYCOM =<job ¢> PP=12,» MP=12 
SCHEDULED: 

BOTH SCHEDULES EMPTY. 

MIX LIMIT=16 


It is necessary that the terminal user be aware of what “signal 
character™ the Server System's SMCS is currently using. To find 
outer the fotlowtny command is ent2red to query that character: 


~-> SIGNAL | (Server SMCS) 


CURRENT SIGNAL CHARACTER = $. 
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Now the terminal user can “sign on™ to an application progran in 
the Server Systems and aiternately enter commands to the Server 
System's SMCS. A series of following interzctions exemoltfy this 
concept: (The application progran “SET/TABS”™ used tn the example 
is assumed to “set™ specified tab stops in the us2rts terninal.) 


“=> SIGN ON SET/TABS (Server SMCS) 


SIGNED ON TO "SET/TABS's SIGNAL="$* 


“=> $J085S CServer SHCS) 


ACTIVES 

SERVER/NC =<job #> PP=15»5» MP=15 
SERVER/SYCOM =<job #> PP=L2s MP=12 
SET/TABS =<job #> PP=4»5 MP=4 

SMCS =<job #> PP=L3» MP=13 
SCHEDULED: 

BOTH SCHEDULES EMPTY. 

MIX LIMIT=16 


“=> 102202390 24025026079 (Server AP) 


(tab stops are now set) 
REMOTE FILE CLOSED BY "'SET/TABS*» STATION SIGNED OFF 


ww> EX DMPALL>FI OUTP.FILE INV 2 (Server SMCS) 
DMPALL =<job 4> BOJ.~ PP=9%» MP=9 TIME = 11°235:21.8 
% OMPALL =<job #> ENTER SPECS 
DMPALL =<job #> ACCEPT. 

--> <dmpalt job #> AX COPY USKLST SHCS/TRACE 120 9 


% OMPALL =<job #> ENTER SPECS 
DNPALL =<job #> ACCEPT. 


“=> <dmpall job #> AX 
DMPALL =<job #> EQS. TIME = 11236:258.1 
At the point in time when a user 18 finished entering commands to 
SYCOM and wishes to terminate the sessione the following command 
is entereds howevere the terminat ts stitl “attached™ to SYCOM. 
“=> DISCONNECT (User SYCOM) 


STATION DISCONNECTED 
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TERMINAL OPERATIONS CSMCS CONTROLLED) 


When a terminal is permanently attached to» and owned bys the 
SHCSr the terminal user must gain access to SYCOM functions thru 
the use of explicit SHCS commands. These commands are exampled 
below. By gaining access to SYCOM» the SHCS will temporarily 
"attach™ the requesting terminal to SYCOM for the duration of a 
session. Howevers a terminal user is not limited to just a few 
SMCS commandsr a user may tnvoke any command which the SMCS has 
in its repertoires with the excention of those restricted to 
input from the SPO. 


Example Interactive Terminal Sesston 


aaa Oe TF BBO Betts wBPasewre ann agewtwtmadiasaqge| =a 


The terminal at this point is attached to the User System's SMCS. 
In order to gain access to those nifty SYCOM capabilities» the 


terminal user must make use of the SMCS “SIGN ON" and “SIGN OFF™ 
commands. The sample session which follows» shows the terminal 
user just how easy it is to “get on” and “get of f™ SYCOM: Cinput 
from the terminal is identified by the flag. *=->".) 


“=> SIGN ON SYCUM (User SMCS) 


SIGNED ON TO 'SYCOM's SIGNAL=x® 


When the “sigqned-on™ message is returned to the terminale that 
terminal is then attached to 5YCOM. Therefore» SYCOM commands 
are entered directly as examoled below: 


“=> o WHAT ; CUser SYCQM) 


SYCOM ONLZINE*s IDLE 
THIS STATION NOT CONNECTED telRORHR rE, I 
LOCAL HOST = USERL» REMOTE HOST = SERVERIL t 


“<-> UT OMPALL CUser SYCOM) 
FILE DMPALL START TRANSMISSION 

“=> «WHAT CUser: SYCOM) 
SYCOM ONLINE> OO FILES QUEUED? SENDING OMPALLC477/385) 
THIS STATION NOT CONNECTED ote G- Bei tenatinape ( 


LOCAL HOST = USERL+ ReoMOTE HOST = SERVERI { 
FILE OMPALL END TRANSMISSION ; 


> ii, 


ny 
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“=> .CONNECT (User SYCOM) > 


CONNECT INITIATED 
CONNECT COMPLETED 


“=> WHAT (User SYCOM) 
SYCOM ONLINEs IDLE . 
THIS STATION CONNECTED USE-RED0-f ay? 
LOCAL HOST = USERL» REMOTE HOST = SERVERI 
““> *REPORT > (User SN 
>01 (SPO) : SIGNED ON TO *SYCOM® 
1 STATION REPORTED AT 11°42.6 08/22/78 
w~w> JOBS (Server SMCS) 
ACTIVE: 
SERVER/NC =<job #> PP=15» MP=15 
SNCS =<job #> PP=1L3-5 MP=14 
SERVER/SYCOM =<job #> PP=12» MP=12 
SCHEDULED: 
BOTH SCHEDULES EMPTY. 
MIX LIMNIT=16 
It is necessary that the SMCS in a Server System have a "signat 
character™ that is different than that of the SNCS in the User 
System. To ensure thiss the following command is entered to 
query that signal character: (CIf it “is not" differents then 
change its “SIGNAL £*"*.) 
“"> SIGNAL CServ2ar SMCS) 


CURRENT SIGNAL CHARACTER = $. 


Now the terminal user can "sign on™ to an application progran in 
the Server Systems and alternately enter commands to the Server 
Systen's SMCS. A series of following interactions exemptify this 
concept: (The anplication program "SET/TABS™ used in the example 
is assumed to “set” specified tab stops in the user's terainal.) 


~-> SIGN ON SET/TABS _ (Server SMCS) 


SIGNED ON TO "SET/TABS*s» SIGNAL = &. 


L aes 
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ams> $J085 (Server SMCS) 
ACTIVE: 


SERVER/NC =<job #> PP=15» MP=15 
SERVER/SYCOM =<job #> PP=12» MP=12 
SET/TABS =<job #> PP=4» MP=4 

SMCS =<job #> PP=L3» MP=13 
SCHEDULED: 

BOTH SCHEDULES EMPTY. 

MIX LIMIT=16 


01 (SPO) = SIGNED ON TO *SYCOMm!® 
1 STATION REPORTED AT 11244.2 08/22/78 


“=> 10+620>30%40%5069-70 (Server AP) 


(tab stops are now set). . 
REMOTE FILE CLOSED BY 'SET/TABS*» STATION SIGNED OFF 


“> .eDESUG (User SYCOM) 
DEBUG OFF 
“> DISCONNECT (User SYCOM 


STATION DISCONNECTED 


At the point in time when a user is finished entering comanands to 
SYCOM and wishes to terminate the sessionr the following command 
is entered: (This ts a SMCS command.) 


-=> *SIGN OFF ' (Us2r SMCS) 
The response from the SNCS will be as follows? 
DETACHED FROM *SYCOM* 


At this pointer the terminal has been "detached" from SYCOGM and is 
now "reattached" to the SHCS. 


SECTION V 


a ee en ee 
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GENERATING THE NETWORK CONTROLLERS 
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SECTION V 


GENERATING THE NETWORK CONTROLLERS 


GENERAL 


This section is provided as a user oriented guideline to the 
generation of a Network Controlter for the SYCOM system. The 
cantroller iS generated by the Network Definition Languag2 (NDL) 
compiler using a prepared set of NOL specifications. The system 
user is required to determine these NOL specificattons according 
‘to the system configuration and environment under which the 
Network Controtler is to function. 


The following guidelines are offered for a target system that is 
to provide the full range of SYCOM services? tncluding terminals. 
They are intended to aid the user in generating a Network 
Controller with correct functional attributes. For a complete 
description of the NOL snecifications and defintitionser refer to 
the "Network Definition Language reference manual* Cassoctated 
documentation). 


DETERMINING THE SPECIFICATIONS 


ee meee ee ee cee ee ee ee ree ee ete ee ee Ur ome ee en 
Oe OO mn RAD OP A ED et OE CO AGM AED OR DY RS os ew OS eo wee 


The following sample Network Controtler NDL specifications are 
presented in a sequence similar to that of the NOL references 
manual. This allows the user a logicat reference for evaluating 
the sample NOL specifications for application to the installation 
requirements. They identify suqgasted parameters which produce 
an operational Network Controtler program for the Steen System 
configuration as specified. 
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OPERATIONAL PROCEDURES 


ee ee ee ew ne eee eee ee eee ee eee ee 
a oe a a a ee ee ee ee ae ee ee ee ee ee a ae 


The following procedures provide the methods by which the user 
prepares the input to the NDL compilation process» generates a 
Network Controller» and induces modifications into the resident 
NOL compitere if required. 


Preparation of Input 


The NOL “*source™ input file can be prepared in the form of either 
acard file or a NOL type disk file. The disk file could be 
created and maintained ustng CANDE or anak Nee text editor of 
Similar capabilities. 


The "Sample NOL Parameters File" is furnished for the purpose of 

creating this file with the most amount of accuracy in the least 

amount of time. Any adjustments to this source file for number of 
Lines» terminalsr and other such attributes is the responsibility 
of the user which is attuned to the system configuration and its 

operational environment. 


Compilation Process 


Prior to initiating the NOL compitation orocesse the user should 
ensure the presence of a “8.0 NOL/LIBRARY” file on diSke of a 
11/03/78 or later vintage). Then» there are several sethods by 
which the NOL compilation (generative) process can be invoked. 
Fotlowing are two of these methods: 


le. Card Input: 


Following is a primitive example of a NDL source card 
input decks (The <I> tn the example helow represents an 
“*invalid"™ character as required by the CP.) 


<I> CO YSER/NC NOL LI 
<I> DATA CARDS 


NOL source images 
NOL tibrary catts 


<I> END 
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2. Oisk Input: 


This method is used to initiate a NDL compiler prozess 
when the source input file resides on disk. Enter the 
following. MCP command using the system SPO: 


~=> CO USER/NC NOL LI*SFI CARDS NAM USERNC/SOURCE DSK DEF 


From this point ons the compilation procedures are the samee wAhen 
the MCP executes the NDL compiterr a normal "BOJ" message is 
displayed. Upon successful completion of the compile» the normal 
“EOQJ" message is displayed. However» if an error message such as 
the one below is disotayed: 


NDL = USER/NC =<job #> --EVALUATLON/PROGRAM POINTER STACK 
OVERFLOW DS OR DP 


Then the "NOL Compiler” must be modified to increase its "name/ 
value stack” size. 


Print The USER/NCNIF File 


Once the compilation/generattion of the Network Controller is 
complete» it ts suggested that the “Network Information File™ be 
printed. This is accomplished by executing the fotlowing programs 
and providing the correct file name (Cif different than the one 
suggested): 


==> EX NIF/SANALYZER? FI NIF NAM JSER/NCONIF <et x> 


NIF/ANALYZER =<job #> BOJ. PR=4 TIME = 1120522721 
NIF/ANALYZER =<job #> EQJ. TIME = 1120721229 
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SAMPLE NDL SOURCE FILE (LOCAL USE& SYSTEM) 


a ee ge ca Om mney ce cet eee es ie yee ee eee ee eee eee ee wee ees es et ee eet 
De ee eee eee ae ee ee ee ee ee _ _ 


Following is a sample NOL source file to be used as input to the 
NOL compiler for the generation of a Network Controller oriented 
to a User Systeme. This example provides a Network Controtter 
which services a local site of 3 terminals» 2 virtual terminals, 
and a inter~system connection. The user must tailor this sample 
Network Controller specifications to the needs and desires of the 
installation Ce.9.+ more/less terminalsr more/less virtual 
terminal posttions» etc). 


This sample NDL input file is comorised of both NDL Statements 

. and parameter specifications. The resulting Network Controtter 
wilt provide the correct functional attributes nacessary for the 
operation of the SYCOM systems in testing mode. 


$ CONTROL 
$ LIBINFO 
$ NSSIZE 20 Z number of entries; for IOLOG 
$ VSSIZE 150000 ZX number of bits; for TOL9G 
Zaeaa srs Stas sscsrtSera sa sese se eee ssaess esses sesa sa sess s seats ees tSe=sssyZ 
% rd 
v4 Declaration Section z 
yA 4 
L==z= SREB EUOM RSS SSR RMS SST STAB SS STB SBS Sr Se Se sr Tass sss srsassr sees seszs sere =X 
DECLARATION: 

NIF = "USER"/"NCNIF®. _. & NIF file namerz user option 

MAX FILES = 16. 

MAX BUFFERS = 2. 

MAX MESSAGES = 20. 
$ LIBRARY SYCOMDECL 
LoS SSBRS BRST R SS SST eT TSS BTS PS Ss Ss SBS sess sss ast sr ss sess senses essress=X 
z Zz 
2 Requests and Controts z 
yd z 
{acs2sacrsessecsSesss ses ss Sse Sssr sess Sst SSeS St Se mmrsuaemesessessecssze=Z 

LIBRARY SYCOMREQ 

LIBRARY CANDEPOLTD hae 

LIBRARY CANDEFSLTOD hee 


LIBRARY SYCOMCTL 
LIQRARY CANDETOCTL Zee 


eh Eo te OF 
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* 

{asassssSSSsec eS sean S=ssseSsssseseas= mamsrtases ts sesstsst sess seteserers =X 
z z 
z Network Configuration z 
y 4 z 
YesSsersserossrrtssssesssst Sess ss esses sstses Sess Sts 2t Ss sess scse ses sssercees7% 
LeBSSSSn RS Sov eter so see sess Sess rs test esses esses sssssassessssrssscssssser7Z 
z Zz 
y 4 Terminat Section Zz 
y 4 z 
“=== SSssssiasecssssSsSsseseteSsssscssessssssssescecse sess sseselsssens sess =7 
TERMINAL DEFAULT SYCONDEFAULT: 

REQUEST = SYCOMREQ:RECEIVE» SYCOMREQ:S TRANSMIT. 

TRANSMISSION = i. 

ADDRESS = 2. Z Number of polling address characters 

BUFFERSIZE = 3840. % 2 x 1920 bytes j 

TYPE = ott ( | Z Required for virtual terminal asg's 
TERMINAL SYCOMTERMINAL? 

DEFAULT = SYCOMDEFAULT. 
TERMINAL DEFAULT TOFLT: - Zier 

REQUEST = CANDEPOLTD: RECEIVE» Yaw 

~~ CANDEFSLITDS TRANSMIT .Za« 

TRANSMISSION = OQ. Lut 

ADDRESS = 2. Za 

TYPE = 4%. Lee 

BUFFERSIZE = 2250. Xk 
TERMINAL TD824: Ze 

DEFAULT = TOFLT. Lut 
Zasa sess sscshea sss esSSss se see sss sa StS SSS SS ee Sess Ses estes SsescSes = 7 
x z 
y 4 Station Section z 
p 4 z 
YesSe terse San rer aes BBS SB SS SKM SS TL SSAA BBB S reassess sss se sess ssrsetrssseszzZz 


STATION OEFAULT SYCOMNDEF: 
FREQUENCY = 250+ 259. % MCS Controller 
MYUSE = INPUT» OUTPUT. 
TERMINAL = SYCOMTERMNINAL. 
RETRY = 25. 


STATION DEFAULT TOB8DOF: Let 
FREQUENCY = 249% 249. Z«* Non Remote SPO 
MYUSE = INPUT» QGUTPUT. aa & 

TERMINAL = TNB24. Zee 
RETRY = 4. La 


capability?? 


Latte ew me ee eee oe ae mm — & = 2 ee MSE OO SEE NO ee ae eR ee a nae a ee om 
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STATIGN CONTROLSTL= 


DEFAULT = SYCOMDEF. | 


ADDRESS = "90". 


STATION SPOST2: 


DEFAULT = SYCONDEF. 
ADORESS = "01%. 
STATION CARDST3: 
DEFAULT = SYCOMOEF. 
ADORESS = "02". 
STATION PRINTERST4: | 
DEFAULT = SYCOMDEF. 
AODRESS = "03". 


STATION FILESTS5: 
DEFAULT = SYCOMDEF. 
ADDRESS = "04". 


NRNHRMRNMNMNRRANNANNM KN KNNN NN KH NN 


tsn 001 


isn 002 


isn 903 


tsn 004 


tsn 005 
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i 
{ 
1 
] 
1 
i 
] Must be grouped. 
' ; 


> ee eee Eee ee ee 


Dontt have to be 
first stations 
defined. 


{Ran aS eR Sea annals SsSee eset sa SS st sass moe e es a a a 


STATION USERTI? 
DEFAULT = SYCOMDEF. 


ADDRESS = “"Aa™» “ah. 


STATION USERT2: 
DEFAULT = SYCOMDEF. 


ADDRESS = "Pate “aP". 


NRHNRNRNNM NAN 


tsn 006 


isn 007 


* Virtual terminal 
CSPO/terminats) 


* Virtual Terminal 
CProgran) 


{wren 6 a a a of at ow a ma 2 wt a Ge oe GN a of GS oo AR DAR SASH HR SS SARS HNTH SONATA ane 


STATION D1: 
DEFAULT 
ADDRESS 


TOeDF. 
"Di. 


FREQUENCY = 249% 250. 


STATION D2: 
DEFAULT 
ADORESS 


-TDBDF. 
"O02". 


FREQUENCY = 249% 250. 


STATION D3: 
DEFAULT 
ADORESS 


TOSOF. 
"D5". 


FREQUENCY = 249% 250. 


isn 008 


isn 009 


Remote 


{sn 010 


1 
t 
| 
Remote SPO { 
! 
t 


> Local terminal 


SPO 
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Z==s= ete o ooo oe ee ee ee ee ee ee ee ee eS 2 2 e222 2 2 2 ee ee 2 ee ee 
z z 
% Line Section % 
Z y 4 
Pasa sere stssstssrssessrssasstssssesss pi — 2 sac eecc seam seses=Z 
LINE OTRECTOL: 
CONTROL = SYCOMCTL. 
STATION = CONTROLST1>» SPOST2» CARDST 3» PRINTERST 456 FILESTS» 
USERTIi»s USERT2. 
ACDKESS = 1:29:36. yA Cline» adapters» port? system) 
LINE DEFAULT LINEDFLT: Lee 
CONTROL = CANDETOCTL. Lan 
AUTOPOLL = 15. Zee 5S x max stattons/tines 
LINE MULTIO4: . %** adapter 4° 
DEFAULT = LINEOFLT. Xe & 
STATION = Dl» O02, O03. Ree 
ADORESS = 12924. : “Zee Cline» adapter» ports system) 
F, See ee a 0 een ce re Em OD ne OE a Oe Oe a Om a On OT ee ee On OS OE Om OO OS MO ON SS OE OP om Oe OD me GY a nD ee a a oe ms os 
FILE LINKS: x for SYCOM 
FAMILY = CONTROLST1» SPOST2>» CARDST3e PRINTERST4e FILEST 5S» 
USERT1- % rsnts OOle OO25 O03» O04» 
% 095% 006 
FILE &FUSERS: % For program-to-program I/0.- 
FAMILY = USERT2. Z rsn O01 
FILE TERMINALS: %*e This file is named "TERMINALS" 
_&ee when SYCOM is run without the 
%*« = =6SMCS. It must be named 
Z** "MCSREMOTE" when SYCOM is run 
Xt subordinate to the SMCS.. 
FAMILY = Die D2» 03. Z*e rsnts O01» O02» 003 
{ren nas enw ener nema nena enenaaes alalateteteheheetatetetatatatehetatatetate wae ccnee- x 
FINI. 


Source configuration notes: 


janelle diene lna-Mivaeme Bier Amel ar Dh ve onedaoteendiineApenelle-aDiheadiin~calten-diipers-Aieartivoe-AieneAipsaatiinaiibernia 


FE ah me ee ER ON cae Se en re ke ee ae ea, 


If the User System does not have "local terminals" then att tines 
in the above example with comments indicated with "Z%*e" can be 
omitted from the source file. 
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SAMPLE NDL SOURCE FILE CREMOTE SERVER SYSTEM) 


ae ee ee ee ee ee ee ees eet em ee eee ee ee es ce ee ee et ee ee 
ee en ee ee ee ee ee 


Following is a sampte NDL source file to be used as input to the 
NUL compiler for the generation of a Network Controtter oriented 
to a Server System. This example provides a Network Controlter 
which services one remote site of no terminalss an inter-system 
connectionsr and a SMCS. The user must taitor these sample test 
Network Controller specifications to the needs and desires of the 
installation Cew.ge» tlocat terminals» more/less virtual terminal 
positionse etc). 


This sample NOL input file is comorised of both NOL statements 
and parameter specifications. The resulting Network Controtler 
will provide the correct functional attributes necessary for the 
operation of the SYCOM systems in atest mode. 


$ CONTROL 

$ LIBINFO | 

$ NSSIZE 20 Z number of entriess for IOGLOG 

$ VSSIZE 150000 ) Z number of bits? for IOLOG 
JLSSSSSPBSTSSTSSSHSSSSSSSSSSMSSSSSSSSSSSSTSI Sse ssssessesesesessesssess7Z 
z z 
z Declaration Sectton Zz 
z z 
ye oe ee ee ee ee ee ee et ee ee ee ee ee a 


DECLARATION: 

- NIF = “SERVER"/"NCNIF™. Z NIF file names user option 
MAX FILES = 16. 

MAX BUFFERS = 2. 

MAX HMESSAGES = 20. 


$ LIBRARY SYCOMDECL 


. 
De ee ee I ee ne ie eR ere Ege i na Dee Rhee Eee Aire pe aad ll -rdlivns Th, dh ell andie nh - dd 
ances r= nS ean = ar = ea es ee ee ee ee ee 


Ce ee a a al ae Eile leiden dip eae asealipvortaedlla Apatite 
ne eS ee ts a ee Ae On Se ee a me OE AE Ok GE soe ED ey OE ae cee mee ie ee SS wien ES SS OE AO em SN mee CRY ee mee ney Ot a OY mee ee Ger ae aes er om et ee ae ae a am 


nen wer rN 
Pp) 
14") 
Fo) 
ec 
is") 
“ 
er 
A 
et) 
=) 
Q. 
oO 
° 
= 
ions 
oo | 
eo 
es 
w 
NRHN NRNM 


$ LIBRARY SYCOMREQ 
$ LIBRARY SYCOMCTL 
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ee dd 


a | 

y Terminal Section 
Z 

z 


ee ee ee ne ee ed 
a Ut amy ee: a PG ND ST SS SN PNP ly eee DE EN ES Se en SE ee ee 


TERMINAL DEFAULT SYCOMDEFAULT: 


30 Nov 1978 
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Ssseeeezeecessszezzf% 
ys 

Zz 

4 
SSssScsescsssssss=57 


SYCOMREQ:TRANSMIT. 


REQUEST = SYCOMREQ? RECEIVE? 

TRANSMISSION = 1. 

ADDRESS = 2. % Numb2r of polling address characters 

BUFFERSIZE = 3840. Z2 x 1920 bytes 

TYPE = 44. Z Required for virtuat terminal msgs 
TERMINAL SYCOMTERMINAL: 

DEFAULT = SYCOMDEFAULT. 
VaesSs=22 SSBSVST SS SVS SS STS SSS SSS SSS sass SscSs Saas SseSessss sa seSsaessaess sss 7 
z . Zz 
z $tation Section z 
% z 
Zonas SBS Ses t SSBB sre sercs strstr sess tresses stesessess =. 2S 2S SS SSS S522 === 7 
STATION DEFAULT SYCONDEF: 5 

FREQUENCY = 259» 250. % omMCS Controlter capabitity?? 

MYUSE = INPUT» OUTPUT. ; 

TERMINAL = SYCOMTERMINAL. 

RETRY = 25-6 
Zt ee ne cn ee oe ee ne en a oe om me om ee ee ee an as oF ow Aes Fe BDeOanae ten anaansanan es aw Z 


Yo ean enwaaen 
STATION CONTROLST1L: Z sn 601 1 
DEFAULT = SYCOMDEF. z t 
ADDRESS = "00". oe 4 1 
. Zz I 
STATION SPOST2: | x sn 002 1 
DEFAULT = SYCOMDEF. x aA 
ADDRESS = “O1". z i 
» 4 t 

STATION CARDST3: z lsn 003 > 
DEFAULT = SYCOMDEF.. z ! 
ADDRESS = "02". x { 
2 ~ 4 
STATIGN PRINTERSTS: % (sn 004 1 
DEFAULT = SYCOMDEF. x { 
ADDKESS = "03". z ] 
z { 
STATION FILESTS: xz tsn G05 1 
DEFAULT = SYCOMDEF. 4 i 
ACORESS = "Q4"., 2 ! 
Yo eee mn mnee 


Must be grouped. 


Don't have to be 
first stations 
defined. 


ye = & o a Ge = an ae ww a ow 86 a OP Ge oF OS a8 OF a oe =m Ee @ wh eS oe om we aa om ee ee me ee ee oe Y 
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STATION SERVERT1? XZ sn 006 * Virtual terminal 
DEFAULT = SYCOMDEF. 4 CSPO/terminals) 
ADORESS = “*adA"s “*Aa™, z. 

Z 

STATIGN SERVERTE? % isn 007 * Virtual terminal 
DEFAULT = SYCOMDEF. Z (Program) 

ADDRESS = "aP"™» "Pa". % 

4 

Z4=== eSB SS 3S VSS SF SSS SS STS SSS SBSH RSS TSS SRS SSS SSS SSS SSS SSSR SESS SS Se Z 

y 4 z 

% Line Section z 

z r4 

Ysoeesecse seers astsssss Yo ee 2 ee Z 

LINE DIRECTO: 

CONTROL = SYCOMCTL. 

STATION = CONTROLST1» SPOST2» CARDST 3+ PRINTERST4e FILESTS» 

SERVERTL» SERVERT2. . 

ADDRESS = 1:0%0. % Cliner adapters ports system option) 
Lennon “Em ae oe Bm Pe MER HSK ARBRE SBT Be ESOS ge wee we sawn ean name ana a 7 
FILE LINK: % for SYCOM . 

FAMILY = CONTROLSTLe SPOST2> CARDST3>» PRINTERST4» FILESTS. 


% rsnts OOLe O02» O03» 004% 005 


FILE RFSERVER? 
FAMILY = SERVERT2. 


For programeto-programn I/0- 
rsn OOL 


defined here because the 
Sample test prograsn is a 
Single user program. 


mM wn NM ze 


FILE MCSREMOTE: 
FAMILY = SERVERTI. 


This file is used for the 
virtual terminals assigned 
to Server System's SMCS. 
rsn 001 


Nae MM 


FINI. 


8 om a ee ee Re ete ener ee ere te ee 
OT ee ee ee ree ee nae ee a eee OR ek ee em wee eet ae 


The Network Controller source fit2 for a Server Systea “with 
local terminals" is configured by appropriately adding thea NOL 
Statements identified in the User System example with "Zee" as 
comments. 


Note: There is only 1 device 


SECTION VI 


ar ee OR te ewe oe ee me art ere ee mie ee eas eee ee i ee eee eee ee ee am on 
CE ee ee ee ee ee ee eee Se ee es. SS Ss 


APPENDICES 
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APPENDIX As ERROR MESSAGES 


DESCRIPTION 


During command processing various errors nay occurs the response 
error messages and their meanings are shown below. There are six 
classes of these error messages: 

» Command Error Messages 

e Command Patornstconal Messages 

e System Parameter Error Messages 

« system Error Messages 

« System Condition Messages 

e system Fatal Messages 


The following error message groups describe alt messages that may 
be displayed in each of the above identified message classes: 
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Command Error Messages 


The following error messages are displayed as the result of the 
improper use of SYCOM commands. sieneratlhy» an error can occur 
for one of two reasonss they are: 

1. Invalid command syntax 

2. .Invalid parameter data 
Although the reason for each error message 1s recognizable» there 
has been no attempt to group the messages into one of the two 
categories. fhe following conmand error messages are however»s 


grouped atphabeticatly» by commands to make Locating easier for 
the user. 


COMMAND MESSAGE REASON 


UNRECOGNIZED COMMAND "“<token>" 


This simply means that the Last SYCOM command entered 
was not a valid command. : 


e ABORT: 


ko a a a ee 


THERE IS NO *PUT® IN PROGRESS TO ABORT 


An ABGRT command was entered with a specified option of 
of "PUT" and no file is being transmitted at this time. 


THERE IS NO *FETCH! IN PROGRESS TO ABORT 
An ABORT. command was entered with a specified option of 
of "FETCH" and no file is being received at this time. 
UNRECOGNIZED OBJECT OF “ABORT" “<token>* 


The command was entered with an option keyword which 
was neither "PUT" or “"FETCH™. Try againe.. 
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Command Error Messages Ccontinued) 


COMMAND MESSAGE REASON 


= oe 
7 om at ae oe 


This command cannot cause an error message. 


UNRECOGNIZEO COMMAND "CL <token>*" 


The .CL command was ent2red either without an option 
or the option was found to be invatid. 


eCONNECT: 


— ae On ey 88 ae ea oe ne 
a ae ee ow we os 


PCONNECT FAILED™: VIRTUAL. TERMINAL TABLE FULL | 


This message displayed indicates that alt allocated 
“virtual terminal" positions are currently in use. The 


terminal user must try again at a tater time. 


ee ee et te 
ca a SP et oe 


INVALID USERCODE SYNTAX 


The "=" equal siaqn deliniter is missing between the 
keyword "USER" and the assSuaed usercode character 
stringe 


CAN'T SPECIFY USERCODE TWICE 


The "“usercode™ entered ts already tloqged~on to SYCOMs 
thereforer a second user with the same identifier ts 
not permitted. . 
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Been SOM 1 SH OO BH BU ERE SB TE OBST BT OBEN A 2 me we 


COMMAND MESSAGE REASON 


1978 
146 


ea") 


eCOPY Ccoont inued): 


ee ee ea ee ie ere ee eee ce oe 
ee a aD on ee ee ee ee ee ee eee ne ee ee mee 


INVALID USERCODE Wee 


The “usercode™ entered was rejected because it contains 


nonsalphabetic characters. 


USERCODE MAY NOT HAVE MORE THAN 17 CHARACTERS 


The tength of the “usercode”™ entered exceeded a maxinum 


allowable Length of 17 sharacters. 


INVALID PASSWORD SYNTAX 


The "=" equal sign deliaiter is missing from between 


the keyword "PASSWORD™ and the assumed password 
character string. 


CAN*T SPECIFY PASSWORD TWICE 


The “password” entered has already been specified by 


another user? it was rejected for this reason. 


INVALID PASSWORD tite 


The “password™ entered was rejected because it contains 


nonmatphabetic characters. 


PASSWORD MAY NOT HAVE MORE THAN 17 CHARACTERS 


The Length of the “password” entered exceeded a maximum 


allowable Length of 17 characters. 


INVALID FILE ATTRIBUTE: <tokan> 


The command syntax dvoucted a keyword of "US"s+s "USER»s 
or “PASSWORO" which was not located. Howevere what was 


entered is displayed in the message as “token". 
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Command Error Messages Ccontinued) 
COMMAND MESSAGE: REASON 
COPY Ccontinued): . 
INVALIO FILE ATTRIBUTE DELIMITER: <token> 
The "COPY" syntax requires a comma “»e* between the 
attribute "<usercode>“" and the keyword "PASSWORD". 
INVALID TERMINATION OF FILE ATTRIBUTE LIST: <token> 
The command syntax caltts for the “*usercode-password™ to 


be delimited by a ")" close paren which was not located 
in the command string. The character Cor characters) 


that was found is displayed in the error message. 


FILE NAME MISSING 


The command syntax requires a “file nane™ specified 
that is the subject of the file transfers it was not 


given or was not recognized. 


KIND DEFINED TWICE 


The “KIND" option keyword has been previously specified 


in the command string. 


HISSNG oom 


The 
betwee 
which as ™® Ng. 


mmand syntax 


INVALID KIND ATTRIBUTE 


The kind option keyword was not “PACK"s “"PETAPE">» 
“WTAPE™,» “"TAPE7™.e or “TAPE9" which makes what was 
entered invalid. : 


ires a "=" equal sign det Tai ter 
and the kind os ion keywords 
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Command Error Messages (continued) 


COMM AND MESSAGE REASON 


eCOPY Ccontinued): 


Oe nd 
A am LP EP A SE Oe rE a Ot Dae oe eee oe 


HOST ATTRIBUTE DEFINED TWICE 


The “HOST=<host=name>"™ attributes were specified twice. 


nissNg "=" AFTER ATTRIBUTE | 

i al sign sotsafeor used betuget the 
ST" and th oe stem name" 15 Be 
The host system name entered was rejected because it 
contained nonwmalphabetic characters. 


INVALIO HOST NAME 


HOST NAME HAS MORE THAN 17 CHARACTERS 


When a host system name is entered with more than 17 
characters (maximum allowable)» it will be rejected. 


UNRECOGNIZABLE VOLUME ATIRIBITE “<token>" 


This message is somewhat misleading in that it is onty 
an indication that a keyword of “KINO"™ or "HOST" was 
expected and not found. 


MISSING "e+" BETWEEN VOLUME ATTRIBUTES 


An attribute separator character of "ss" tis required by 
the command syntax to indicate the end of the attribute 
"KIND" and its assoctated option beyworas It is not 
there and it is wanted. 
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Sees sacenaneseent an ehwsn 2e BOB SEE OT FOO hnwnaeneetuw en 


COMMAND MESSAGE REASON 


ween west nt BBC OB FB ee BT SABHA ESM SEEABNSE SBS BCE TS KC OBE DE SVs neewoeeswnanGas Bee am we 


eCOPY Ccontinued): 


ry ee ae A A lem aR OE ED eS Ore 
et ey OR ee ee a Oe 


NO VOLUME ATTRIBUTES DEFINED 


Neither the "KIND" or the "HOST" keyword attributes 
were specified in the command string and "HOST" is 
required as a minimum. 


VOLUME HAS MORE THAN 17 CHARACTERS 


The “volume name" Cor packwid) entered exceeded the 
maximum allowable length of 17 characters. This message 
could relate to eitner "*volume-i"* of “*volume~2" names. 


DESTINATION HOST NOT ONLINE 


The Destination Host Name specified in the COPY command 
string is not 3 “*local" or “remote” system identifier. 
Thereforese the request cannot be accepted as is. 


INVALID DESTINATION HOST NAME “<token>" 


The “destination” system name specitied is not the same 
as the “locat" System name. Thereforer because the name 
is not known to SYCOMs it cannot process the request. 


SOURCE HOST “<system=id>* NOT DEFINED OR REMOTE HOST 
"<system-id>"” NOT ONLINE : 


This message can be disotayed for any one of Several 
reasons; they are? 1) the system identifier specified 
as “source host" is netther the “lLocal™ system or the 
current “remote™ systemer 2) the required syntactical 
keyword “FROM” is missinge 3) SYCOM 18 not connected 
to the source host specitfiede or 4) required parens 
are 1S missing. 


SYCOM Software Operational Guide 


Company Confidential "°c. Santa Barbara Plant Page =~ 150 


Section VI Appendices (Revision “a™) 


Command Error Messages Ccontinued) 


Been ware Re BD BSH Be OBO BOBO ew oe aw eane 


COMMAND 


MESSAGE REASON 


eCOPY Ccontinued): 


ms eee ee eet a ee ee ee Oe ee ee ee em ees oe eee 
ee cee ae aa OD OD Oe OD SN GS ae te ce See AS em a me 


INVALID SOURCE HOST NAME “<token>* 


The system tdentifter specified as a “source host” does 


not match the “*local”™ system names the "remote" system 


name» and tS not olanks. The request is not processed. 


CANNOT FETCH WHEN REMOTE SYCOM OFFLINE 


This message 1s indication that an interssystem tine 
connection does not presently exist and the "FETCH" 
request cannot be accommodated. 


SOURCE AND HOST NAMES MAY NOT BE DEFINED IN A FETCH 


FILE 


FILE 


FILE 


; 7 ; Paice) 
Use of the shorthand version CFETCH) of the COPY 
command implies the source and destination systemse 
therefores they cannot be specified. 


<file name> IN USE AT DESTINATION-“PUT ABORTED 


This message is displayed when SYCOM 185 attempting to 
“send” a file to the otner system and the specified 
file is currently in use on that systen. 


<file name> IN USE AT DESTINATIGN““FEICH ABORTED 


The file tin question has oeen received and when closing 


it Cwhich removes existing named filed» finds that the 
file to be reptaced is in use. The FETCH is aborted. 


<file name> NOT FOUND 
The object file for a PUT fite transfer was not found 


in the disk directory Cdtsk) or was not online (tape or 
disk pack). 
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Command Error Messages (continued) 


COMMAND 


MESSAGE REASON 


eCOPY Ccontinued): 


on a am me we my me 
ee et ee ae we ae eo 


FILE 


FILE 


FILE 


FILE 


FILE 


— me es ee ee 
ee ee ee ee 


<file name> LOCKED 

The object file for a PJT file transfer was found to be 
"Locked" in the disk directory (disk). 

<file name> FILE TYPE CANNOT BE TRANSMITTED 

The dis« file specified for the file transfer is not 
one of the file types which SYCOM can transfer. (No 
code tiles disk-tape or tapecrdisksr only data files.) 
<file name> SOURCE OR DESTINATION FILE NAME MISSING 
This message indicates that a subject file name was 
missing from the conmand string which was entered as 
either a “COPY, “"PUT"» or "FETCH™ from another system. 
<file name> SOURCE OR DESTINATION FILE NAME INVALID 

The specified file name was found to contain characters 
other than those which are considered valid for a fite 


identifiers ors a nulticfile identifier was indicated 
C"/") out was not inctluaged. 


<file name> FILE NAME WAS IDENTIFIED WITH MORE THAN 10 


CHARACTERS 


PACK 


The name of the fite to be transmitted was found to 
contain an identifier tn excess of i0 characters. Its 
the maximum allowable. 


OR USERCODE NOT FOUND@"PUT ABURTED 


' This message would occur when SYCOM was attempting to 


setup for a disk Cor pack) file to be received and the 
destination “disk pack" was not found to be online. 
After the messaye is displayed the transfer is aborted. 
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Command Error Messages (continued) 


MBM OBB EAT ADAM OT EO nawenawenaeuaau 


COMMAND 


MESSAGE REASON 


eCOPY Ccontinued): 


we ee ee cee ee me 
— a a we aun ae em es mee 


FILE 


FILE 


FILE 


FILE 


DEBUG: 


wi oe a ee es 
—t <m one ae aw ne ae 


ERROR 


ee coe er ee ee oe 
pe a) 


<file mame> ALREADY EXISTS AT DESTINATION = PUT ABORTED 


When SYCOM is setting up to "receive™ a disk (Cor pack) 
file, it checks to disk directory. If the specified 


file already exists» this message is disolayed and the 
transfer is aborted. 


<file name> RECORDSSIZE TOO BIG. > 1950 


<file name> TOO MANY RKEZSORDS (€>99999) 


The disk Cor pack) file specified for the file transfer 
contains an excessive number of recordss outside SYCOM 
Limitations. The file cannot be transferred. 


FAMILY NOT ALLOWED 
As suspecteds in the soecified file name» an equal sign 
("=") was found which r2zoresented either a "pack-id"™>, 


"multi-file~id™» or “filesid™. This is illegals the 
file named must be speci fic. 


- "ON" OR “OFF™ EXPECTCO 


The option keyword entered with the DEBUG command is 
not valid. Please try again. 
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Command Error Messages (continued) 


COMM AND MESSAGE REASON 
DISCONNECT: 
This command does not cause an error message to be returned 


but does display an Informational type message under certain 
circumstances? see “Command Informational Messages” in this 


section. 
eEQJ: 
STOP OR WAIT IN PROGRESS 
This means that a *-WAIFT"™ command has heen entered and 
SYCOM is responding to this requests the ".£0J" command 
is ignored. 
eoFETCH: 


ee oe ae oe 


CANNOT FETCH WHEN REMOTE SYCOM OFFLINE 


This message its indication that an inter-system Line 
connection does not presently exist and the "FETCH" 
request cannot be acconmodated. 


SOURCE AND HOST NAMES MAY NOT BE DEFINED IN A FETCH 


FILE 


Use of the shorthand version CFETCH) of the COPY 
cormand implies the source and destination systems» 
therefore,r they cannot se specitied. 


<file name> IN USE AT DESTINATION““FETCH ABORTED 


The file in question was received and when attempting 
to close it (which removes any existing fite copy)- 


finds that the file to 3e replaced is currently in use. 


The FETCH is aborted and the received file is losts it 
must be requested ayain. 
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Command Error Messages (continued) 


COMMAND MESSAGE REASON 


Reese Snes Hw BAS Onset ate BSF eG enna Sanwa ane Sean nna nanan 2s Oenean Geoaanan ea eae 


a ee a ee 
a a om ont 


UNRECOGNIZED OPERAND “<token>* 


This simoly means that an itncorrect or misspelled 
option keyword was entareds and rejected. — 


oOFFLINES 


a ee ee ee ee ee eee ee 
ee ee ee Ie Oe RO ee ne 


STOP OR WAIT IN PROGRESS 


This message indicates that SYCOM is in the process of 
servicing a *.WAIT™ command which in effect produces an 
Yoffline™ conditions the *.O0FFLINE® command is ignored. 


—— on we eu oe oe om 


This command does not cause an error message. 


INVALID PHONE NO> 


This message is returned when the phone number entered 
contains alphabetic characters. 


PHONE NUMBER TOO LONG 


This message is returned when the phone number entered 
cantains more than 20 digits Cincluding hyphens). 
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Command Error Messages (continued) 


Core oe 2 Oe 8 ee ee ee Ue Ue Rms naw aean an anne on awa ea 


COMMAND HESSAGE REASON 


me a es 
a << om 


il « 


ft © 
it oA 


CANNOT PUT WHEN REMOTE SYCOM OFFLINE 
This message means that an inter-system connection does 


SOURCE OR DESTINATION HOST NAMES MAY NOT BE DEFINED EN PUT 


Use of the shorthand version (PUT) of the COPY command 
implies the source and destination systems» therefores 
they cannot be specified in the command string. 


FILE <file name> IN USE AT DESTINATION~~PUT ABORTED 


This message occurs when SYCOM is attempting to “send” 
a fite to the other system and the specified file is 
currently in use on that system. The PUT is aborted. 


ERROR? ".QS" OPERAND NOT NUMERIC 


The QS" command is entered with a non-numeric queues 
$ize integer field and was ignored. It tS necessary to 


reenter the command string in correct format. 


ERRORS "OS™ OPERAND MAY NOT cXCEED 15 


The queue size integer entered was greater than 15 and 
was summarily rejected. It must be retentered with an 
appropriate integer value. 


ERROR: "QS" OPERAND MUST BE AT LEAST 4 
The queue size integer entered was less than the value 


4 and was rejected. The command must be-resentered with 
a legitimate integer value. 
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Command Error Messages (continued) 


fgaeateenwataewe® SOS BE OV Bw wKBaeenee as ean eee wwe ae ws 


COMMAND MESSAGE REASON 


This command does not cause an error message disptlaye but 
hawevers several warnings could occurs refer to "Command 
Informational Messages” in this section. 


eRY: 
UNRECOGNIZED COMMAND “RY <token>” 
The command string contained an unrecognizable option 
keywords not “CP%» "LP"sr or “"CR®. 
eSIZE? 


This i r» the commankd syntax ee 


"requ. 
equal ‘si 3 ing the Size ‘integer. ae 


ERROR: ".SIZE" OPERAND NOT NUMERIC 
The integer entered with the command string was 


comprised of at least one non-digit character. The 
integer must be all digits» no exceptions. 


ERKOR:S ".2SIZE* CANNOT EXCEED 400 
This message is displayed when a size tnteger is 
entered which exceeds the maximum message block size 
established for the systems four hundred (400) bytes. 
ERROR: *.SIZE™ CANNOT BE LESS THAN 78 
This message is disptay3d when the size integer entered 


is less than the minimua allowable message block size; 
for this system the minimum size tS 73 bytes. 


rotcd 
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Command Error Messages (continued) 


COMMAND MESSAGE REASON 


a an ee ome 
ee ee ee 


eV 
UNRECOGNIZED COMMAND "SV <token>" 
The .SV command was entered either without an option 
or the option entered was found to be invalid (not "LP" 
or "CP"™). 
* 
ae cqurt 
ERROR = "ON" OR "OFF"/EXPECTED 
The only valid options to the TRACE command are "ON*"> 
"“OFF™ or none at atl. Something else was entered which 
caused this error message. 
eUSER: 


we ee oe ee owe oe 
ewe ae oe 


INVALID USERCODE “<token>* 


The usercode used to log~on with was found to contain 
digits. Please tog-off and tog-on again with correct 
usercode/password conbination. 


INVALIO PASSWORD “<token>" 


The password which the user sigqned-on with was found to 
contain digits. Please log~-off and tog~on again with a 
legitimate usercode/password combination. 
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Command Informational Messages 


COMMAND MESSAGE Re ASON 


SYCOM CLOSING(E <cycle code>Js CANNOT ACCEPT INPUT 


This mesSage is returned in response to any new command 
entered “after™ an “.E0J" command is entered but prior 
to the actual shutdown of SYCOM. (Once shutdown has 
been initiated» commands are no longer accepted.) 


eCONNECTS 


oe ae ae ee en ee OR ae 0 


STATION ALREADY CONNECTED | 


This oanty means that a ".CONNECT"™ command was entered 
from a terminal Cor SPO) that was already "connected" 
to a Server Systems no problem. 


7) 
no 
i 
iii< 


CAN'T SCHEDULE NOWs TRY AGAIN LATER 


The *PUT/FETCH queue" is presently futls therefore» no 
more “PUT's*® or "FETCH's" can be accepted at this time. 


Ldev 


REQUEST SCHEDULEDs WILL SEND FILE <file name> WAP 


The PUT/FETCH request was queued to disk and witl be 
processed as soon as itn“process and previousty queued 
file transfers have been completed. 


REQUEST SCHEDULED--REMOTE SYCOM OFFLINE 


The PUT/FETCH requested has been queued to disk and 
will be processed as soon as communications have been 
reestablished between the User and Server Systems. 
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Command Informational Messages (continued) 


COMMAND MESSAGE REASON 


DEBUG ALKEADY ON 


The command was entered 
currently on. 


DEBUG WAS ALREADY UFF 


The command was entered 
currently off. 


eDISCONNECT: 


“STATION ALREADY DISCONNECTED 


to turn DEBUG “QGN" which was 


to turn DEBUG “OFF™ which was 


This onty means that a "DISCONNECT™® message was entered 


from a terminal that was atready disconnected; 


ignored. 


ee ee ay ee ee oe 
ee ae me awe 


REQUEST IGNORED: 


This message 15 
entered when an 


REQUEST IGNORED: 


This message could mean 


displayed 
input‘card file 
The entire command string 


it was 


CARD FILE SFILL OPEN 


if a ".READ”" command is 
is currently active. 


is rejected and discarded. 


NOT LOGGED ON 


the card reader 15 not ready. 


fle nar : | 
FILE * 5" NOT PRESENT» TRY AGAIN 


The command “™.READ"™ 
" Rd E ADS" 


Has 


is not present 


entered and the card file 
in the card reader. 


a ee ee ee ee ee ee ee ee ee ee ee ee ee ee 
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COMM AND MESSAGE — REASON 
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TRACE: 


oO nee et ee es ee ee 
ee 


DISK TRACE ALREADY ON 


The command was entered to turn tracing 


was already in trace mode. 


DISK TRACE WAS ALREADY OFF 


"ON" and SYCOM 


The command was entered to turn tracing “OFF" and SYCOM 


Was not currently tn trace mode. 
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System Parameter Error Messages 


The following error messages could ‘occur during the parameters 
input process. The problem indicated appties to both SPO itnout 
as well as card input. In either case» SYCOM must be OStd> the 
problem(s) corrected» and the parameters reentered as required. 


MESSAGE REASON 


INVALID PARAMETER? “<token>® 


This message is displayed when the parameter keyword entered 
did not match one of the acceptable keywords. 


t= EXPECTED BUT GOT "<token>" 


A parameter was entered with a vatue which must be separated 
by an equal (=) character and SYCOM is unforgiving in these 
matters. 


INTEGER EXPECTED BUT GOT “<token>* 


The BUFFER and RECORD parameters require an integer which 
specifies the BUFFER/RECORD size in bytes. AS this is not 
what was entered» what was found is inctuded in the message. 


BUFFER SIZE “<token>"™ EXCEEDS MAXIMUM ALLOWABLE 1950 


The maximun allowable BUFFER size is 1950 bytes. What was 
specified exceeded this Limit. 


INVALID SYSTEM ID “"<token>™ TOO LONG OR TOO SHORT 


The “system id™ entered has exceeded the parameter timit of 
17 bytes. Please shorten it up some and reenter it. 


INVALID PARAMETERS FILEs BEING REYOVED "<buffer size>*” > 1950 
OR WRONG VERSION OF “SYCOM/PARAMNET ERS" 


This message occurs when the "*PARAMETERS™ file is opened» 
the parameters are read tine and the “maximum buffer size" 
was found to exceed the system maximum of 1950 bytes. when 
this conditian is encountereds the "SYCUM/PARAMETERS®" file 
is removed and new oaraneters must be entered. 
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System Warning Messages 


ee eae aetanan wee es awe we a 2 a = te 


Warning messages displayed on the User SPU indicate a problen 

at the system level. They have been rectified by SYCOM so that 
operations can continue without operator intervention. They are 
not generatly considered to be major or extensive in nature and 
therefore» SYCOM has elected to take immediate corrective action. 


MESSAGE REASON 


##E WARNING = REMOTE HOST wanes ame AS LOCAL SYSTEM ID. 


This is really a problem which must be resolved immediately. 
Stop SYCOM and re_create the "SYCOM/PARANETERS™ file with an 
appropriate “SYSTEMID”™ chang2. 


INQ OVERFLOW> FOLLOWING MSG DISCARDED 
<60 or tess characters of messaga> 


If during a Write to a Program-to-SYCOM application program 
an “tnconplete"i/o" occurs» this message is displayed to 
provide the warning for this condition. 


TERMINALS FILE OVERFLOW» MESSAGE DISCARDED 
<60 or tess characters of messaye> 


If during a message Write to the remote file TERMINALS an 
"incomplete ri /o™ occurse the above message 1s displayed to 
inform the system operator of this condition. 


ERRORS INCOMPLETE IO ON LINK FILE 


The complex-wait has interrupted SYCOM for the LINK file 
and the Resuit Descriptor indicates an “incomplete ifo™ has 
occurred. This error 1s logged and SYCOM reverts hack to 
“waitt" mode. 


LINK QUEUE OVERFLOW, MESSAGE DISCARDED 
The queue “LINK.QO” is fuller therefores no more messages can 


be queued at this time. The message in question is dumped 
as there is nothing SYCUM can do with it. 
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System Warning Messages (continued) 


MESSAGE REASON 


Sunn 8 SO IS BOF SAE SSB SOG MH EF BUH BSOSSAA KNEE AMRAE SPOS Se BeERASs’ Be RQeEeORNaA EEE MH EE HRS ae S| 


NUMBER OF TIMEQUTS = <number> 


This message is displayed automatically when “timeouts” keep 
re-occurring on the inter-system line connection. Howevere 
it is only output on an incremental basis (10) to reduce SPO 
output activity. 


LOSS OF DATA*SET“READY 
Display of this message occurs each time the indicated event 
is detected. <A count 15 maintained of these occurr2nces and 


SYCOM goes into the state of "initialization". In progress 
file transfers are aborted and lost. 


HOST SYSTEM CARD READER HALTED 


Khen this message occurs it ts to inform the system operator 
of a candition that presently exists on the remote system. 
No action is required cy the operator. 


HOST SYSTEM CARD READER ABORTED 
This message is used to inform the system operator that card 


reader input from the remote system has been aborted. No 
action is required of the op2rator. 


HOST SYSTEM CARO READER READY 


A message that is used to inform the local system operator 
that card input from the remote system has resumed. 


SYCOM WILL CLOSE WHEN NEXT IDLE 
The "EQJ"™ command has been entered and SYCOM is processing 


previously entered requests. When these requests have been 
processed» SYCOM will terminate. 
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System Warning Message Ccontinued) 


Smeets egiuw Seater OB Oar ananenuwewaetntra st Bee e 


MESSAGE REASON 


SYCOM CLOSING ON REQUEST FROM REMOTE 5 YCOM. 


The remote SYCUM program has been directed to go to "EON" by 
the entry of etther “"E0JS" or "STOP" from that system. When 
this occurs» it sends a control typ2 message to the other 
SYCOM which causes the above message to be displayed. 


ERROR: MESSAGE TYPE = <type code> 


An tnput message from tne remote file "LINK" was found to be 
invalid. The message type code 1s included in the disptayed 
error message for reference. 


REMOTE SYCOM HAS GONE DOWN AND COME BACK UP 


This message is self explanatory in that for some reason the 
remote SYCOM disconnected the Line and then re-established 
communication with this SYCOM resulting in the above message 
being cisplayed on the systea SPO. 


QUEUE RJEQ FULL» MESSAGE DISCARDED 


The queue "RJE2Q" is full» thereforer no more messages can 
be gueued to it and the current message iS discarded. 


#E# WARNING - NO “SYSTEMID™ F## 


Upon completion of the accept SYCOM parameters processes it 
was determined that a “systemeid™ has not been specified 
Ceither not entered or was in error). Atthough it is not 
mandatory that a systemmid be established for some SYCOM 
functions» 15 it necessary when File Transfers or Virtual 
Station connections are to b2 utilized by the system user. 
To recover from this condition refer to “Reactionary Hints 
and Pointers"™s» Section IV. , 


mm - of & ae oe ee le ee ee ew om ee eee ee Oe ee St 
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System Condition Messages 


Any of the foilowing messages displayed on the User SPO indicate 
an abnormal system condition of some type. As a rules when one 
of these conditions is encountered» the display of an appropriate 
message also elicits a response from the system operator. 


MESSAGE REASON 


CARD PUNCH EXCEPTION 
PLEASE ENTER ".RY CP™ WHEN DEVICE IS READY OR ".SV CP™ TO SAVE 
THE FILE 


This message is displayed wh2n SYCOM ts attempting to punch 
a card and an “exception” condition is encountered. 
Generally this indicates that the card punch has gone "not 
ready" for any one of several reasons. tt 15 necessary to 
respond to SYCOM with the appropriate command when action 
has been taken to ready the unit. 


LINE PRINTER EXCEPTION 
PLEASE ENTER “.RY LP"™ WHEN DEVICE IS READY OR *.SV LP™ TO SAVE 
THE FILE 


This message is disolayed when SYCOM ts attempting to print 
a tine and an “"exceotion™ condition is encountered. 
Generally this indicates that the Line printer has gone "not 
ready" for any one of severat reasons. It iS necessary to 
respond to SYCOM with the appropriate command when action 
has been taken to ready the unit. 


PARITY ERROR GN READ PLEASE READ LAST CARD AGAIN 


This messaye is displayed when SYCOM is attenpting to read 
the card file and an “exception” condition is encountered. 
Generatly this indicates that the card reader has gone “not 
ready" for any one of several reasons. It is necessary to 
respond to SYCOM With the appropriate command when action 
has been taken to ready the unit. 
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System Condition Messages (continued) 


MESSAGE REASON 


mn Re ET RY SG ewetiaes es BBB eee es HOt FO See BF an ane Savas ea anaeagn ee G2 OO nn wee 


PUNCH ERRGR 


The card punch has etther detected an error in the last card 
punched or has degraded into a “*not ready™ state. In either 
casere a “suspend” control message has been sent to the 
server System. 


READER ERROR 


The card reader has either detected an error in the tast 
card read» gone into a “not ready” state» or has detected an 
tnvalid character in a card totumns other than column 1. I[f 
there was a read errors the Last card must be put back tnto 
the card hopper. The card r2zader 18 then made physically 
"ready"; all cases. SYCOM must then be informed of this new 
status condition with the entry of a "sREADY" command. 


PRINT ERROR 


CARD 


The Line printer has either detected an error on the tast 
line printed or has gone into a "not ready™ state. In both 
cases a "“suspend™ control message ts sent to the Server 
Systeme. When everything 18 again ready with the printere a 
*"“,READY" command must be entered to inform SYCUM. 


READER CLOSED 


This simply means the card input has ‘been completed and the 
card file closed. 


QC INITIATED 


In doing a read on the remote file "“LINK™ an “"EOF* condition 
was detected. This condition 18s caused by the MCP when a. 
"QC" command is entereds which shuts down all prograas 
associated with the Network Controtler. 
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System Condition Messages Ccontinued) 


HESS AGE REASON 


ERROR: INCOMPLETE YO ON LINK FILE 


In doing a read on the remot2 file "LINK™ an “incomolete io” 
condition was detected. This message merely reports on the 
Situation. 


PHONE NUMBER REJECTED BY NC <phon2 number> 


The phone nunber passed on to the Network Controtter from 
SYCOM was found to be in error and was rejected. 


INVALID CONTROL MESSAGE RECEIVED 


When SYCOM receives a system "control message” from a remote 
system and the "type code" in this message is not within the 
090 - 23 nunber range» then the avove message is displayed. 
The Input message is discarded and no further processing is 
done on its behalf. 


BUG IN NETWORK CONTROLLER. VTT INDEX = <vtt> I.E. STATION WAS NOT 
CONNECTED OR WRONG LSN IN CLOSE MESSAGE. 


A “close™ message has been raceived from the system Network 
Controller for a progran known to SYCOM which contained a 
"isn tList™. This List included a Virtuat Terminal fable 
Index CVTT INDEX) entry for a terminal not signed=on to that 
programs thus the reason for this message. 


LOST CONNECTION TO REMOTE SYSTEM SYCOM 


This message indicates that the communications link between 
the two systems has been interrupted for some reason. SYCOM 
will attempt to revestablish the connection and failing that 
reverts to "Offline Standby™ mode. 
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System Fatal Messages 


These messages are of the typ2a which preclude the automatic 
shut down of SYCOM. There are considered "fatat™ in the outlook 
of continuing operations and therefore» SYCOM is shut down. 


MESSAGE REASON 


FATAL ERROR AT <program sequence > 


The display of this message on the User SPO could be the 
result of any number of reasons. The SYCOM source Sequence 
number displayed is the only clue to the problem. SYCOM 
initiates a “memory dump" at this point and automatically 
goes to €0J after certain disconnect functions have been 
Satisfied. 


REMOTE VERSION OF SYCOM IS INCOMPATIBLE 
HIS VERSION=*<version number>"» MINE="02" 


This message identifies the problem at hand.» SYCOM goes to 
EOJ immediately at this point. 


ANOTHER SYCOM WITH SAME MULTI“FILE“1I0 IS RUNNING 
PuT 
The display of this message indicates that SYCOM cannot gain 
access to the "SYCOM/@MR. QUEUE" File Con disk) as it is 
presently in use by anotaer program. 


PuT 


REMOVE MMF. QUEUE GR CHANGE ITS NAHE IF 7.0 FILE 


If the disk file by that nama is tess than 99 recordser when 
reading ite SYCOM will gat an "EOF™ and aborts immediately. 
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APPENDIX B2 CHARACTER SET 


The following printable characters define the character set 
acceptatile to SYCOM for input messages from terminals. They are 
- arranged by columns in internat collating sequence with “*blank"™ 
tow and "9" high: 


blank & = 2° a h re) Vv C. J -Q W 3 


( ] / $ b i p W D K R x 4 
* $ Hm a c j a) x E L \ Y 5 
< & ° a d k r ‘4 F M S Z 6 
( ) z . e t s z G N T ) 7 
+ , a = f n t A H D U i 8 
! ™ > - g n u 8 I P V 2 9 


It is recommended that the standard “*signat character™ of "«" be 
retained by the SYCOM user for use in message transfers to the 
SMCS. Howeversr if this ts not suitable for any reasons one of 
the following special characters are suggestea:? 


Special data communications characters recognized by SYCOM are as 
follows: 


SOH EQT OLE ENQ STX ETX RS FS 
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APPENOIX Cs RESERVED WORDS 


The reserved words recognized by SYCOM are dependent. uoon the 
position type format. Hence the following list of reserved words 
are divided into the following types: 

« Type 1 - Commands 

« Type 2 -* Specifications 


Hords which are inmediately followed by a word tin parenth2ses are 
interchangeable alternates for that word. 


Type 1 
~ ABORT - DEBUG oLP READ TRACE 
2 ABER 
-8YE eDISCONNECT .OFFLINE RESTART oUS CUSER) 
ect ~EQJ ONLINE eRY WHAT 
CONNECT FETCH PHONE SIZE 
COPY eLISTH -PUT STOP 
CP -LOG as .SV 
Type 2 
AS FROM NR 2 ARAMETERS SAVE TERMINALS 
cP HOST OFF PASSWORD SCHEDULE TO 
CR KIND ON PETAPE TAPE US 


DISK LIST ONTO PUT TAPE? USER 


FETCH LP ; PACK REMOVE TAPES USERS 
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APPENDIX D2 COMMAND SUMMARY 


The following command summary list is presented in alphabetical 
sequence for easy reference. Refer to the command descriptions 
for command syntax and option details. 


~ COMMAND STATION FUNCTI9O 

ABORT any — Abort a PUT or FETCH file transfer. 

BYE any Station log-off roa SYCOM. 

CL SPO Clear Sei tanerak, duvide. 

CONNECT any Request establishment of a terminal to a 
server System. 

COPY any . File transfers (PUT or FETCH). 

OF SPO Inform SYCOM of “not ready” periadheral. 

DEBUG SPO Start/stop input/output message tracing. 

DISCCNNECT any Request for terminal disconnection from 
the Server System. 

EOJ SPO Cause SYCOM into an orderly shutdown. 

FETCH any File transfers (fetch from other system) 

LIST . any Display selective system information. 

LOG SPO Display a list of data comm error counts 

LP SPQ Inform SY COM line printer "not ready". 

OFFLINE SPO Cause SYCOM to break the connection to a 


Server Systeme 
ONLINE SPO Estabtish a Server System connection. 


PHONE SPO Establish or clear phone number. 
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COMMAND | STATION FUNCTION 

PUT any File transfers (put to other system). 

QS SPO- Change Network Controller queue depth. 
READ SPO Open and transmit card input file. 
RESTART SPO Disconnect liner initiatize and standby. 
RY - $PO Inform SYCOM of available perioheral. 
SIZE SPO. Change maximum message block size. 

$TOP SPO Cause SYCOM to shutdown immediately. 

SV SPO | Stop transmitting and “save” file. 

TRACE SPO Start/Stop SYCOM I70 disk tracing. 


USER any Log a user onto SYCOM. 


WHAT any | SYCOM status inquiry. 
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APPENDIX €: COMMUNICATIONS CONTROL MESSAGES 


GENERAL 


As there are several message formats used for inter-SYCOM data 
communicationss each format is specified in detail. These message 
formats are presented in a sequence dictated by the message type 
codee A tist of message types are shown belows followed by 
individual message format descriptions. 


MESSAGE TYPES 


The message type codes are derivatives from the "DAL"/"DA2" 
(Device Address) field. The message type codes apply to nessage 
transmissions in either direction and are compatible between 
system types. Following then are the device address conventions 
used oy SYCOM? alt other values are considered invalid: 


DAIL DAZ Usage 
0 6) System control 
0 1 S$P0 messages 
¢) 2 Card reader/punch data messages 
) 3 Line printer data messages 
0 4 File transfer data messages 
8 2 Packed card punch data messages 
a A User System “transmit™, Server System 
thru "receive", virtual terminat messages 
z Z 
A a User System "“receive™,s Server System 
thru *“transmit™, virtual terminal messages 
Z z 


Device addresses are advisory onty. The receiving system can 
direct a message to any appropriate peripheral genes” based an 
its own requirements. 
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Note that the line printer data is allowed in both directions. 

When a system receives line printar datare it can print it on any 


available printerr independently of whether the system is termed 
a User System or Server System. 


MESSAGE FORMATS 


Basic Data Communication Messages 


As per the line protocols the below message format adheres to the 
criteria of standard RJE message formatting: 


~SATSOD EB 
ORMTAA<coo3e=- m= TEXT some e--- IC 
; HMéXi2 . xc 


The individual characters in this message function as follows: 


Ae. SOH ~ This is the standard ASCII character which is 
used to indicate data transmission as opposed to 
connection establishment communication. 


Be ARM = The “Acknowledge Received Message” character 
which 1s used to accept or reject the tast message 
block received. 


Ce. TTM# - The “TransmiSsion Number” character used in 
the acknowledgement of a messagee It represents 
one of two vatues Calternating characters) selected 
for implementation by SYCOM. The characters "5" and 
"a" are used by the User System SYCUM whereas ths; 
characters “F™ and “U" are used by the Server 
System SYCOM. 


De STX - A standard controt character used to delimit 
the preceding header characters from the message. 


Ee ODAI/DA2 - Two characters representing a "Device 
Address” value. 


F. TEXT ~ The message text field usually contatning 
data (record images or a message). 
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Ge ETX = The standard “end-of-text" control character. 


He. BCC ~ A Block Check Character which is comprised of 
a longitudinal parity bit configuration that 15 
used» by the hardwares to verify that the messag?2 
has been received correctly. 


System Control Message 


System control messages are used to exchange control tyo2 data 
between systems. A complete descriptive list follows the message 
format which is a variation of the basic message fornat: 


SATSDOCC EB 


ORMTAAODD<<““"=- variables (text) "= >TC 
HM#X1212 XC 
"OO" 


Here we have the addition of the *"CDi"/"CD2" characters. These 
two characters represent the system message “type™ codes which 
may or may not be followed by vartable control data. 


SPO Messages 


The SPO Message format uses the basic format without alteration. 
There are no provisions for blocking SPO Messages» therefores the 
rule is: one SPO Message per control message block. The format 
of this type message is as follows: 


SATSDO | EB 
ORMTAAC “2-2 -~--- TEXT semen cem= TC 


HM X12 | XC. 


"Qi* 
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Card Reader /Punch Message 


The format for card reader/punch data images is as follows: T 
gepeN ei Fee ee ne en ee ee ae 
PLLS Cd «6=6CoThHe "RS" CRecord Separator) character used 
between card images provides the means for blocking. 


SATSOD R EB 

GRMTAAG<e""- card image =""">S<7""" card tmage ="-">TC 

HM#X12 XC 
"oO? ba] 


Line Printer Message 


The following format variation is used to transmit Line Printer 
data lines between systems: 


SATSDODP R | EB 

ORMTAAC<K“"-=— Line image w*77>S<-="- Line image =*"">TC 

HM#X12C XC 
"O3x" 


This format is the same as the Card Reader/Punch format except. 
that the "PCC™ character ts uttlized. The value of this field 
can be one of the following codes: 


PCC Function 

0 Prints no spacing 

1 Prints single space 

2 Print» double soace 

A Skip to channel 1 Ctop of page) 
B ™ 2 

C * 3 

0 bid 4 

E al 5 

F ad 6 

G - 7 

H ai 8 

I bis 9 

J. . 10 

K re 11 

L ~ 12 Chottom of page) 
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File Transfer Message 


The File Transfer message format is also the same as that used to 
transfer card images. Although the "PCC” character field is 


includeds it is only there to maintain message conformity: 


SATSOO R E8 

ORMTAA<S9"-"=" record data -*"2">$<er""record data “-"*>TC 

HMEéX12 XC 
"O4* 


Virtual Terminal Message 


Qe en Ge es BBE BB t aes ow Bet wo = 


The message format utilized for virtual terminal messages is the 
basic message formats» with one exception: the “device address" 
for a virtual terminat is comprised of two letters (1 lowers 1 
upper “transmit™: 1 upper» 1 tower "“receive™) and witl vary by 
terminal. The format is as foltows: (Terminal and SPO messages 
are "not™ blocked.) 


SATSDD | EB 
DRNLAACAe oe ee ee ee message text “---- “See STC 
HM&X12 XC 


*xx™ (Ctransmit) 
"Xx™ (receive) 


File Separator Messages 


This message format is utitized by SYCOM when it its necessary to 
transfer a “symbolic file header™s inuvicate the “beginning of a 
file"» or indicate the “end of a file". This apolties equally to 
the “Card Reader/Punch*se "Line Printer™,» and “File Transfer" 
opecations. To accomplish this» there are three minor variations 
to the File Transfer Message format which are identified with the 
following message formats. 
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Begin File Message 


The format for the Begin File message is as follows: 


SATSODF ; EB 
ORMTAASI<-~-— file name ---->TC 
HM #X12 XC 

"Oo2% 

"Q3" 

eg4a" 


End File Message 


The format for the “end file" message tis as follows: 


~SATSODF EB : 6 

a fle na ——> >. 

HM &#X12 c 
eC: 


Program=to~Program Messages 


The following message format pertains to SYCOM's "program-to- 
Program” facititys thru a “Remote File™: 


REMOTE.KEY (10 characters) % Message “header*"™. 


- LENGTH (C( 4) Z Length of message text. 


- TYPE % Message typer usually "000". 


MESSAGE TEXT (nn characters) % Maximum ts “"buffersize"™. 


qt 


Relative Station Number for 
“yirtual terminat™ as defined 
for the program-to~progranm 
remote filer usually 7001". 


NNNR 
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Program*to~SYCOM Messages 


SYCOM has the inherent capability to accept command strings from 
an application program and respond with reply messages thru the 
"Program=to-SYCOM" interface facility. This facility utilizes the 
“queue” mechanism» whereby SYCOM ceads input from the queue file 
"SYCOM/OUTQ" and writes replies into the queue fite "SYCOM/INQ"™. 
CIf these queue file names seem reversed» its because they are 
oriented to the application program.) Input/Output message 
formats are defined as follows: 


Input CSYCOM/ING): 


0 08 ore me a ee ee eer oe eee ee ee ee 
Ce ee ee ee ee ee ee) 


Filler 10 bytes 
SYCOM command string 1980 bytes Cmaximum) 


nme awn Bo @ m agq@eawewmweaeans wee as = eae Sees CSE KBE OSB Bea ee we 


20-00 bytes (naxiaum) 


Output CSYCOM/OUTQ): 


mee OR re ees ee i ees a ee ee ees ee 
a a Oe a ea ee em a ae oe a om ae em a ae a om 


Filler 10 bytes 
ps reply message 1990 bytes Cmaximum) 


a rtqgmaww a & SSCA BAMA BARMERA BM BORE MSE BT ann SH MB am 


euge bytes Cnaxiaum) 
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APPENDIX F2 RESTRICTED MCP COMMAND SUMMARY 


ALL input commands that are orefixed with a “?" are sent directly 
to the MCP exactly as entered. The MCP then generates apuvropriate 
responses which are sent to the terminal via the Network 
Controller. Security restrictions have imposed certain 
constraints on MCP commands from remote terminals. Alsoe certain 
commandse such as those which alter system optionse purges or 
clear system peripherals» have teen disallowed for a remote 
terminal. The fotlowing List reomesents the MCP command subset 
permitted from User System terainals and the User SPO. 


The following Command Subset is listed in the order as described 
in the B18GC/B17900 Systems System Software Operational Guide 
Cassociated documentation). <Any command ltisted below which is 
suffixed with "US" requires the command to be entered with a 
valid “usercode"/"password™ combination. 


Library Maintenance Instructions 


e CH Change (US) 
« AD Add CUS) 

e L0 Load (US) 

« OU Dump CUS) 

« UN Unload CUS) 
e RE Remove CUS) 


Program Control Instructions 


« CO Compile CUS) 

« OY OYynamic 

e €X Execute CUS} 

« WMH Modify Header (US) 
« MO Modify (US) 
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Program Control Instruction Attributes 


« AF After 

« AN After.Number 

« CA Conditional 

« CG Charge (certain restrictions apply) 
« OS Dynamic.Spaces 

e FI File 

« FR Freeze 

« HO Hold 

° IN Interop interpreter 
- IT Intrinsic.Name 

« I0 Intrinsic.Directory 
« ME Menory 

- OV Gverride 

« PR Priority 

« SC Schedule.Priority 
« SW Switch 

« TH Then 

« UC Unconditional 

« UF Unfreeze 

« UV Unoverride 

« VI Virtual.Disk 


System Control Instructions 


e AX Response to ACCEPT 

« BF Disptay BACKUP files. (CUS) 

« CP Compute 

« CU Core usage 

e OF Date of file CUS) 

« DM Dump memory and continue 

« OP QODump menory and discontinue 

- DS Discontinue progran 

« FN Display internal file name 

« FR Final reel of unlabeted tape file 
FS Force from schedule 

« GO Resume stopoed program 

« HS Hold in waiting schedule 

» HW Hold in waiting schedule untit job EU 

» MR Close output file with purge 
MX Disotay MIX 


e« UF <OQpttonal file response 

» OK Continue processing 
« OL Oisolay peripheral status 
» PD ODisotay directory 

e PM Print memory dumo 

« PR Change priority 
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System 


Controt Instructions Ccont inued) 


PS 
QF 


Prod schedule 

Query file (US) 

Query program 

Remove backup files (US) 
Remove duplicate disk file 
Remove jobs from schedule 
Change schedule priority 
Suspend processing 

Set switch 

Time and date 

Time interrogation 

Test switches 

Assign untabeted file 
Display MCP date . 

Display current MCP and interpreter 
Disolay schedule 

Display MCP time 

Program status interrogation 


Job Spawning Control Attributes 


QU 
US 
ZQ 


Queue command 
Usercode command 
Zip queue command 


MIX related MCP commands may refer only to jobs initiated 
Same remote terminal where the initial command was input. 


MCP commands must be entered in UPPER CASE ecw ce 


Page 
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APPENCIX G2 PARAMETERS FILE ATTRIBUTES 


we ef ee ee ee eS ee ee hee ee ee a a eae a ee le eT Tee 


The PARAMETERS file is a disk fila» data type» with one physical 
record of 180 characters. This parameters record is formatted 
as shown betow. 


Record Format 


Length Default 
Field Cin bits) Value description 
VERS to 
Filler +04 ee Reserved for identifier. 
CURRENT.DATE 3 Run date as “dd mm yys (9 
bytes). 
STATION. IO 136 coe System identifiers 17 bytes. 


STRATTON EDS EENGTH Pa ———__9-— —“engtr of system identifiers - 


MAX. BUFFER.SIZE 24 4909 File Transfer buffer size. 
95 OY) } 
TIMEQUT. INTERVAL 24 0 A value for message display 


intervals. 


AUDITING 1 Q DEBUG on/off switch. Default 
of "0" inhibits trace list. 


QUE.P 1 0 When “set™,s this parameter 
, permits “program~to=SYCOM" 
communications. —~ 


NOFTP.P 1 0 When “set"™,. this parameter 
permits File Transfers to 
occurs else they are denied. 


NOFS 1 0 . When “set™» this parameter 
inhioits File Separators. 


WAIT .P 1 0 To shutdown or not shutdown 
when recetving a "disconnect 
message" fron another SYCOM. 
0 = shutdowns L = idle. 
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Length Default 
Cin bits) Value 
DISK-TRACING ; 1 1 
Filler 2 00 
TRACE.R.8B 24 4 
TRACE-BeA 24 10 
TRACE. AREAS 24 10 
TERMINALS.RF& 24 000 
wee AME 240 
HhedtisN0 32 
Filler 128 
COMPILE.~DATE 72 = 
Filler 128 A 
COMPILE-TIME 80 oes 
Filler 


He 
(lem Ar 


vest A 


oor 


{Ue 


Lo 
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Description 


HER EHO VAR BS BAO ess ast ama eae wae wm 
? 


Controls disk tracings O=no 


l=yes. 
Reserved for future use. 


Disk traces records per blk. 


Disk trace» plocks per area. 


Disk tracer number of areas. 
Remote Fite Number for the 
file TERMINALS? 3 bytes. 


SYCOM's namey 30 bytes. 


SYCOM'S “job #3 


4 bytes. 
Reserved for identifier. 


Compite date 
(9 bytes). 


as “dd mmm yy™s 


Reserved for identifier. 


Comoile time as "*hhtamess.t* 


(10 bytes). 


Reserved for future uUS@eccece 
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APPENDIX Hs SUMMARY OF FILES 


External Name 


30 


Pag 


Nov 1978 


e-°* 1865 


(Revision "a"™) 


Size 
BO/1 
BO71 

132/1 

455/1 

132/1 

varies 
varies 
1989/1 


2000/1 
2009/1 


2000/1 
3547/1 
455/71 
1680/1 


80/1 


4559/1 


4557/1 


Program Internal Name | Device Usa 
SYCOM —-s«sRJECARDS.=——=i«RSECARDS=—~*~*«éR@~SCTCBO 
RJE PUNCH RJe /PUNCH Punch* 0 
RJEPRINT RJE/PRINT Printers 0 
LINK LINK Remote 1/0 
LINE LINE Printer*« 0 
IN <file name>«« Disk/Tape I 
OUT <file name> Disk/Tape 0 
TERMINALS TERMINALS Remote I/0 
ING SYCOM/INQ Queue 1/0 
DUTQ SYCGM/OUT9 Queue 1/0 
LINK. 9Q SYSOM/ INK. Q Queue 1/0 
Sh cio Se ree DiskCR) 1/70 
RJE.Q SYCOM/RJE.Q Queue 1/0 
FP SYCOM/PARAMETERS Disk 1/0 
CARDS CARDS Reader I 
SYCOM/NC LINK LINK Remote 1/0 
SMCS NHCSQUEUE MCSQUEUE Remote 1/0 
* Note: Printer or printer backup disk file. 


** Note: The actual file name as specified in the 


COPY command. 
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APPENDIX Is SAMPLE APPLICATION PROGRAMS 


Pagl 
om om GR Che a kh an 8 ee OHM SKC OSB AM OS MK SRNR Wns ew GS Qa Been enwananenuveanweaensw ene 


This program was designed basically to test “program*to-program”™ 
communication functions of SYCOM. What this samole application 

program provides is the mechanics of what is necessary for this 

communication process. The user tan expand upon this samote to 

create a program with the desired capabilities as required. The 

program is written in UPL which is available for this purpose. 


The only data communication type functions required for this type 
of application program is to "read" input messages from a Remote 
File and “write” reply messages into the same Remote File. This 
message interfacing architecture has been established for this 
purpose and must be» therefore» adhered to at all times. 


PROGRKRAM@TO"“PROGRAM CUser System) 


a ee ee ee ee ee ee we mk ae ee ee ee se ee wen ee ee ee ee eee ee ee ee ee ee ee ee see ee ee oe eee eee 
OF ee ae Ee eee ee ee ee ee se ee ee ee ee ee ee me em ne ete ee ewe a SEP a ane OD Oe om au Se Se A ee ED a a ne 


COMPILE USER/TEST UPL LI; 


ya This application program tests program-to=program 

z communication using SYCOMs tn the “USER SYSTEM. «a0 

Z on a) ou as en ee an oe oe on 

& DETAIL a 

& SIZE , 

Z & EXPAND_DEFINES XREF XMAP % Cuser optional ) 

& PASS_END 

FILE RFUSER (CDEVICE = REMOTEr NUMBER_OF_STATIONS = Le 
REMOTE_KEYe RECORDS = 80/1» BUFFERS = 2)3 

DEFINE CH AS ACHARACTERES 

DECLARE TEXT | . CH €B0O)» 


REPLY CH €80)» 
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DECLARE 12 RMT_KEY 

2 RMT_KSN CH C 3)» 

2 RMT_LENGTH CH € 4)» 

2 RMT_TYPE CH € 3)» 

1 READ_KEY CH €10)» 

2 KEAD_LPSN CH € 3)- 

2 READ_LLENGTH CH € 4)» 

2 READ_TYPE CH € 3)% 
RMT_RSN s= "OOL": % First station in "family"™. 
RMT_LENGTH = "Q080"; % Standard message tength. 
RMT_TYPE s= "960"3 %~ MSS type code. | 


OPEN RFUSER INPUT. QUTPUTs 


DO TEST_LOOP FOREVER, 
ACCEPT TEXT> 
% Could check for special: input nessage 


WRITE RFUSER (CRMT_KEV) CTEXT)s 


READ RFUSER CREAD_LKEY] CREPLY)=> 


ON EQF STOP, 
DISPLAY REPLY; 
END TEST_LOOP: 


% The above program toop will never ends 
FINI; 


feo ered nario Elhanedliom atl adhered cn Dae Be ie el nad dl on dt Eo Dreteead adie Maret perall Mien dihe Din EitemedA eden En A nod 
ee eed) 


& In case of 


for E0J stuff. 


Outputs messages 
directly to the 
Network Controller 
for delivery to the 
other system. 


NNR ANH 


% Obtains input directly 
% for the Network 
Z Controller. 


“oc™ 


it must be BS'td. 


— ee em eek eet ee ee wee ee eee ee: 
— a OS oe ee ee ee ee ee ee 
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PRCGRAM*TOSPROGRAM (Server System) 


oN er Noe Eien Aire Mhane Byam linen Mby andirnnedigie re dil -Mitennediienscdta-_MiaseienadlhceollibesaAian-adlieeenes Minas Miler Mihnns Shee Meese Meee Mion ee Sipe —Apon Ah on Aan Aga nar De ae DE acer edn A ee Ae ornare es Der nora A ad Aaa nen oe pre e- an pre ne ewe An nn ————d 
a et a oe nn LUD DD OR Ee em ED ee OO oe mY a DE We GS a PY ee Ge SS ee a ee ee ee ee 


COMPILE SERVER/TEST UPL LI 


z This sampte apolication program tests programto7program 
Zz communication using SYCOMs in the "SERVER SYSTEM™sece 


Z Ss ee ee 


&8 DETAIL 
& SIZE 
& PASS_ENO 
FILE RFSERVER CDEVICE = REMOTE» NUMBER_OF_STATIONS = 1» 
REMOTE_KEY» RECORDS = @0/1» BUFFERS = 2)% 
DEFINE CH AS ACHARACTER@s 
DECLARE TEXT : CH CBC )»>. 
1 RMT_KEY Cd (10)> 
2 RMT_RSN CH € 3)» 
2 RMT_LENGTH CH € 4d» 
2 RMT_TYPE CH € 3)» 
1 READ_LKEY CH €10)> 
2 READ_RSN CH € 3)» 
2 READ_LENGTH CH C 4)» 
2 READ_LTYPE CH € 373 
RNT_RSN 3= "O01" “First station in "family" 
RMT_LENGTH 2= "0080", % Standard message length 
RMT_TYPE := "900"%3 % MCS type coce 


OPEN RFSERVER INPUT» OUTPUT? 


DO TEST_LOOP FOREVER, 
READ RFSERVER CREAD_LKEY? CTEXT); 
ON EOF STOP: 
WRITE RFSERVER CRMT_KECY] CTEXT)s 
END TEST_LOOP: 


Input from User AP 
In case of "QC"™.. 
Output to User AP 


RNY 


% The above program toop wilt never ends it must be O0S'd. 
FINI: : 


Dene eee ee ee eel alee Eina din dpctipardipeee tp anicdiiee—AheradianAientthadties dart nl ndnatina Ae Eee ee Eh od cede andres ter Eiae Ee Ee Read ied A 0 Aen Ehren vce Mpc Eon Dela an adl reer nol 
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SECTION VII 


GLOSSARY OF TERMS AND ACRONYMS 


This glossary defines SYCOM terms and acronyms used throughout 
this software operational guide. For ease of user the glossary 


is separated into two sections’ Terms and Acronyms. Each section 
is sequenced alphabetically for quick reference. 


TERMS 
' TERM DEFINITION 
ACTIVE STATION: A work station (terminal) that is 


currently 2tligible for entering or 
accepting messages. 


AMERICAN STANDARD 

CODE FOR INFORMATION : 

INTERCHANGE CASCII): This coder established by the -American 
Standards Association» defines codes for a 
set of characters to be used in the inter- 
change between business equipment over 
telephone and teiegraoh circuits. The code 
consists of 128 graphic and control 
characters. | 


APPLICATION PRUGRAM: A program that processes data and is 
unique to ane type of application. It is 
sometimes referred to as a “user orogram". 
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AUTO CALL UNIT: A device furnished by the communications 


common carrier which attows a User System 
to automatically establish a diated link 
to a Server System over a communications 
network. 


BEGINNING OF JOB 
(B05): The execution of a single program unit to 
be overformad by the system. 


BINARY CARD: A punched card with multipte punches in 
any one or more colunns which represent a 
non-ASCII character. 


BIT: The smattlest unit of information in a 
binary system. 


BITS PER SECOND Cbps): The expression bits~per-second 1s used to 
express th2 soeed at which bits of data 
are transmitted over a communication 
channel or internally moved within a 
computer system. 


BLOCK: A group of characters/bits transmitted as 
a single unit of datae Also» see Block 
Check Character. 


BLOCK CHECK CHARACTER : 

(BCC): The Block Check Character is a character 
appended to data blocks transmitted for 
the purpose of error detection and parity 
control. 


BLOCKING FACTOR: The maximun number of characters allowed 
per single transmission. 


BROADCAST: The simultaneous dissemination of 
information to a number of work Stations 
(terminals). 
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TERM 


BUFFER: 


CARRIAGE CONTROL: 


CHANNEL & 


CHARACTER: 


COMMON CARRIER: 


COMMON CARRIER 
EXCHANGE : 


COMMUNICATION LINE? 


CONDITIONED LINES: 


CONNECTION: 
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DEFINITION 


This is temporary storage that is used 
during the transfer of data from one 
device to another. I[t is atso used to 
compensate for variations tin bit rates or 
timing of events within the system. 


Controls tne vertical paper motion for a 
line printer. 


A device that directs the flow of data 
between a comouter's main memory and 
input/output devices. 


A digits latter» or speciat character . 
(Letters can be upper or lower case.) 


A companye such as Bell Telephones that 
provides communication lines as a public 
service. 


A defined arear served by a communications 


carrier» within which the carrier provides 
service. 


Any medium» such as a wire or a telephone 
circuit» that connects a terminal with the 
computer. 


These are private and teased transmission 
lines that are conditioned to reduse data 
distortion while providing transmission of 
data at lower error rates. 


An established data transmisston path 
between two or more conputer systeas. It 
is considered either a temporary or 
permanent connections aepending on uhether 
it ts estavlished with/without switching 
facilities» resoectively. 
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CONTROL CARD: A punched card which contains information 


Which identifies a job or describes its 
requirements to the MCP. The first column 
must contain an invalid character in 80 
‘column cardse a question mark "2" tin 96 
column cards» or a null character 2902 for 
remote jobs. 


CONTROL STATES The term “control state", for this system» 
refers to a program that can assune 
control of the system's processor with 
privileged operands. As a rules» the type 
of control state porogram suggested here 
infers an “operating system” or MCP. 


CONVERSATIONAL MODE: An operational mode in which message data 
. Cfult or partial messages) is used in tieu 
or» or in addition to» controt characters 
as replies for message information. 


DATA: Data is any representation of informations 
such as charecterse to which meaning might 
be assigned. 


DATA COMMUNICATIONS: Data communication is a method of 
transferring encoded data by means of 
electrical transmission between two or 
terminals and/or systems. 


DATA COMMUNICATIONS © 
SYSTEM: A data comnunications system consists of 
two or mor2 computer systens that are 
Linked by neans of a communication 
Line(s) for the purpose of data exchange. 


DATA LINK? A comoosite of computer systems and the 
interconnecting networks together with 
control procedurese operating ina 
patticular mode that pernits infornation 
to be exchanged between these systems. 
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DATA SET: A device that provides an interface 


between a data communications system and 

a data comnunications line. Most data 
communication lines use a modulated 
carrier for data transfer. The data set 
provides the logic to modify the data from 
being received or transmitted between 
terminals and the system. 


DATA SET READY: 3 A signal provided by the Data Set. 


DATA TRANSMISSION: Data transmission consists of transmitting 
data between two or more computer systems 
in a system network. 


DISCCNNECT (CDEQT): The term Cand mnemonic) for the "DLE E€OT* 
communication control sequence which is 
used to Signal that a "disconnect" of a 
switched circuit must be initiated. 


DIAL~OUT: The use of an Auto Call Unit to establish 
a "“switched™ connection between two (2) 
computers. 


DIAL “UP: The use of a dial or touchtone data set to 
establish a “switched™ connection detween 
two €2) computers. 


DISK CARTRIDGE? A secondary data storage device much the 
same as a "disk pack" but usuatty smaller 
in size. It can be moved on-line or 
off-line. 


DISK ODITRECTORY:: A disk=resitdent table that contains the 
name and type of ftle-r togather with a 
pointer to the disk file header or sub« 

- directory for all permanent files which 
reside on dtsk. 


DISK PACK: A secondary data storage device that can 
be moved one-line or off-line. 
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DISK“PACK~IDENTIFIER 
dp-id): An identifier which is the name assigned 
, to a disk pack or disk cartridge. 


EXTENDED BINARY CODED 
DECIMAL INTERCHANGE 
CODE CEBCDIC): A code consisting of 8-bits which is used 
. to reoresent 256 unique letters» numberses 
and special characters. 


ERRORS Any receiv2d character or sequence of 
characters that does not conform to those 
transmitted are considered to be in error. 


ERROR RECOVERY 

PROCEDURES: These are data communication control 
procedures usad to restore normat 
operations to a data-tink after an error 
has occurred. 


FAMILY NAME: A identifier used as a file name» or the 
name assigned to identify a main file with 
subdirectory entries. 


FILE SECURITY: The procedures or special devices used to 
prevent access to or use of data or 
programs without authorization. 


FILE IDENTIFIER: Atl disk file-identifiers used on the 
system must be unique to prevent duplicate 
file~names. A file identifier can be 
comprised of any combination of the 
following filertdentifier options: 


‘ fileridentifier 
e familycnane/file-identifier 
dorid/family-name/filetdentifier 


HALF “DUPLEX CHANNEL: This is a communication channel in which 
the signaling may be in either directions 
but not in both directtons simultaneously. 
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TERM 


DEFINITION © 


HALF DUPLEX 
TRANSMISSION: 


HARD COPY: 


IDENTIFIERS: 


INTEGER: 


INTER-SYSTEM 
COMMUNICATIONS? 


INTRA“SYSTEM 
COMMUNICATIONS: 


JOB: 


JOB NUMBERS 


This is a type of data transmission where 
information is sent in only one direction 
at atime. It cannot send data in both 
directions simultaneously. 


Generally» the orinted copy of some 
material in a readable form is considered 
to be “hard copy". This would include 
computer printed media such as Reports, 
Listings» and Documents Like this. 


A word consisting of from one to seventeen 
alphabeticer numerics or special characters 
in combination. 


A whote number as opposed to a fractions 
that iS» a number that contains the unit 
of Cone) an exact number of tines. 


The ability for a terminat or program tn 
one system to communicate with a program 
in another system. 


The restricted ability for a terminat or 


program in a system to communicate with 
another program in the same system. 


A *job* to this system is any program that 
is executadle under the control of the 
MCPs SYCOM is a job. 


A unique number assigned by the systems 
MCP to each job that is executed under its 
control. 
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JOB SPAWNING: The ability for a user to execute jobs 


under program control and maintain an 
adequate tevel of control over these jobs 
during their execution. 


KEYSQARDO: A device for the encoding of data by key 
depressions which causes the generation of 
the selected code element. 


LEASED LINE= A data transmission Line reserved for the 
exclusive use of a customer: (data center). 


LIKE SYSTEM: : A “like system” is a system with physical 
characteristics simitar to those of a 
target system. For a 61800/B1700 system» 
a “fLike™ system would be either a 81800 or 
B1700. 


LINE: A data communications line linking two (2) 
computers or a computer and its associated 
terminals. 


LINE ADAPTERS A line adapter consists hardware and/or 
software logic used to interface a data 
set or comnunications Line into a multi- 
Line or single-line I/70 controt unit. 


LINE SWITCHING: The technique of temporarily connecting 
two communications lines together so that 
two computers and/or a computer and its 
associated terminals can exchange data. 


LOG- OFF : The procedure by which a user ends a data 
exchange session either between two 
computers or between a computer and a 
terminal. 


LOG-ON: The procedure by which a user establishes 
a data exchange session between two 
computers or a computer and a terminal. 
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LOGICAL STATION NUMBER 
CLSN)ds The identification number assigned by the 
: Network Controller to a given Station 
(Terminal). The Logical Station Number 
has no retationship to file namese but is 
determined by the order in which a station 
is defined in the Network Controller. 


MASTER CONTROL PROGRAM 
CMCP):2 The Master Control Program is the master 
"control state” program Conerating system) 
used in the B81800/81700 series computers 
for system control. 


MESSAGE: A sequence of characters arranged in a 
form suitagle for the purpvose of conveying 
information. <A message contains the data 
to be conveyed (the text) and maye in 
additionsr sontain communication characters 
to aid in the routing or handling of the 
message. 


MESSAGE FORMAT: A message format defines the placement of 
message elements within the message text. 
These elements would be such items ass 
header» control characters» and text data. 


MESSAGE HEADER: Every message moved between a terminal and 
; the SMCS» or an anplication program for 
that matter» is prefixed with a "header". 
This header contains station attrioutes 
necessary to tdentify the station when the 
time comes to return a reply message. 


MESSAGE NUMBERING: Message nundering is the sequencing of 
messages transmitted by the communications 
system to ensure all messages sent are in 
turn received. 


MODEM: Same as Data Set. © 
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MULTIFILE IDENTIFIER 
CMFrI0): 


MULTI“LINE CONTROL 
CHLC):3 


NETWORK s 


NETWORK CONTROLLER: 
NETWORK OEFINITION 
LANGUAGE CNDL): 


NORMAL STATE? 


OFFLINE: | 


A generalization for a group of files with 
the same “family name” but with different 
file names. | 


The (MLC) is an I/O control device that 
provides the functional control tetween 
computer hardware and the line adapters. 
The controt is an integral part of a 
multictlLine communications subsystem. 


A number of data communication linas 
connecting the User System witn remote 
work stations Cterminats). 


The NOL generated data communication 
program used by the SYCOM to tnterface 


with the work stations Cterminals) and 
other systems. 


A descriptiver free-form languages for 
defining and implementing a data 
communications network. The NOL compiter 
analyzes the input statements and 


generates a custom Network Controller. 


The term “*normal state", for this system> 

generatly refers to a program which has no 
facitities to setze control of a system's 

processor, as opposed to "control state". 

Ceege» SYCOM ts a normal state progran.) 


There are two facets to this term for the 
SYCOM syst2ar 1) a system is "offline" 
when no coamunications link currently 
exists between it and a host systems and 
2) a systeus? terminals SPO» or program is 
"offline™ when tt 1s not togically 
connected to an application prograa in a 
host systeag. 
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ONLINE: 


PARTICIPATE: 


PASSWORD: 


POINT-TO-POINT 
CONNECTION: 


PRIVATE LINE? 


PSEUDO CARD READER? 
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DEFINITION 


There are CWO MEANINGS tor this term in a 
sycom systeas 1) a S¥Stem is eontine™ when 
a communications Link CUrrentty exists 
between it and 2 host systea that provides 
cocessima servicess and 2) 3g reorminal> 
Sppe OF DLOIESE AN 8 USer System is 
wontines wren mets logicatty =onnected to 
an apotication prograg in 4 hose speicws 
cthe syster must Ce online in aeger for a 
terainale SPUs oF Program ta ne ontine.) 


supervisory Message Controt system (SMCS) 
whicd allows rt to Particingra= in alt 
rfoutpul pee pa ao ews >Ztween the 
atcoller and an gontgear;: 

. rteation 
programe iF reference to a SFIODM systems 


su"S FS Not permis SR 
the S%<5 pen tted" t3 nsarticipate 
in SYSQNTS BESS Age traffic. 


pap be 


ge string of characters - sat - 


A untd 3 
peor adresse operator, o7 user must 
bragiy ta eeet security raquicacects 
beaters valving access CO dazz--sies. The 
passxir9 confidential as vtt=xsed to the 
wiysersssess 
sence outta ath on IN wytty @ network 
conwetiot is estadlished cesgaen tuo, and 
onty ts=* weicpunce tied The 227 -z--tion may 
inctast 4 geitcning facility. - 
nie oo 2 et8 COMMUATDz== ons Line 
whicr tes FFS9 turntshed to t+) sor for 
exciedr¥t 4326 
tng BStheeied systems a ogee card 
reanet ve ba fact a disk file. “Tne disk 
fite ere Tr Feeated Via Carss. x ogram 
outsc+ tia a ferarnal., = sree 2 progras 
eee ieee file. 7 y+  Dseudo 
Marg repre sa Se Substitutes os erat 
rode asotoartately Lasse. a+. 


fits ce 
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QUEUES A logical collection of messages awaiting 


transmission or processing. 


REMOTE JOB: Submission of control stataments and data 
from a remote station Cterminat/computer)>» 
causing the job dascribed to be scheduled 
and executed at another system. 


REMOTE JOB ENTRYCRJE)2 The Remote Job Entry program is a saethod 
be which a remote computer executes or 
compiles programs sent to it by other 
computerss which are considered terminal 

‘devices. 


REMOTE SUPERVISORY 

CONFROL STATION CRSCIsS This is. an input/output device tocated on 
a User System Cremote to a Server System) 
to provide the operator with the ability 
to control jobs and to request tnformation 
from the Server System. 


RJE/TERMINAL: The official name for the software system 
from which SYCOM derived its basic 
capabilities. 


RJE STATION: For this system» the terms "RJE Station" 
and “User System" are equivalent. The new 
term is used to denote a system with many 
additional capabilities and potential. 
therefores the term “RJE Station" is no 
longer aporopriate. 


RELATIVE STATION 
NUMBER CRSN)5 Is the position within the Remote File 
familys assigned at generation time. 


SEMANTICS: The relationship between symbols and their 
meanings. 


SERVER SYSTEM: A Server System is a passive system which 
provides computing services to the "User 
System"s tocally or remotely. 
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SESSION? The period of time during which a user 


engages in dialog between a terminal and a 
computer or between two computers. (The 
elapsed tine between when the user logs-on 
the system and when the togroff occurs. 


SESSION NUMBER? A unique number assigned by a originating 
System to each session. 


SINGLE LINE CONTROL 
(SLC): This is an I/0 control device that 
provides the functional controt between a 
computers nain frame and a tine adapter. 
This control is an integral part of a 
single tine communtcations sub-system. 


SITE ID: A unique if~character identifier sent in a 
spectal message to a server system prior 
to being tlogged“on to provide a positive 
means of identification» independent of 
any other system security. 


SPO: The accepted term for the B1800/B81700 
systems “supervisory console™ (VOT or 
Teletype). This term has been derived . 
from the oodsolete acronym for “Supervisory 
Printar Output". Usage in this document 
4s for an abbreviation for User Spo. 


SPO LOG: A disk file that contains all input/output 
messages sent to and received from the 
User SPO. 

SPOOLING: The reading and writing of input/output 


data streams on secondary storage devices» 
in a format convenient for tater output 
operations and/or processing. 


STATION: Same as “TERMINAL®™. 


SYCOM Software Operational Guide . 30 Nov 1978 


Company Confidential 


Section VII Glossary 


TERM 


SWITCHED LINE: 


SWITCHING: 


SYNCHRONOUS 
TRANSMISSION: 


SYSTEM DISK: 


TERMINAL: 


TEXT? 


TRANSMISSION: 


TRANSMISSION BLOCK: 
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A communications tine in which a temporary 
connection between a User System and a 
Server System is established by dialing. 


This is an operation involving the intere- 
connecting of circuits in order to 
establish a temporary communication link 
between two or more systems. 


A data transmission process in which the 
sending and receiving devices are 
operating continuously at substantially 
the same frequency and are maintaineds» by 
means of corrections tin a desired dhase 
relationship. 


A disk pack or disk cartridge that is 
initialized as a system pack. A systen 
pack is under control of the MCP and one 
or more must be present on the system for 
the MCP to function. Headper-track disk 
is always considered system disk. 


This tS an input/output device designed to 
both receive and send source data in an 
environment associated with the jo3 to be 
performed. Furthers it is capable of 
sending entries tore and obtaining output 
frome the system of which tt is a part. 


A sequence of characters forming to 
information to be conveyed. 


Same as. Data Transmission. 


A transmission block may contain att or 
part of a message block. A transmission 
block ts tndenendent of the messag2?2(s) 
from which its characters are taken. 
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TRANSPARENT MODE: An operational mode in which alt coded 


combinations of eight-bit characters are 
atlowed as message text characters. 


UNIT DEVICE IDENTIFIER 
Cudid: The mnemonic identifier assigned to each 
peripheral device attached to the system. 


USER SPO3 ot The User Systea's Supervisory Control 
Station (V)T). 


USER SYSTEMS: A User System is the active participant 
system providing local service to the user 
Wishing to utilize another computing 
resources tocatly or remotely. 


USERCGDE : A symbol which consists of from one to 
eight sharacters to identify the user. 


VIRTUAL TERMINAL: A Logical communications capability which 
. permits a terminals» SPO» or program in one 
systea to “interact™ with an application 

program tn another system. 


VOT: Video Display Terminal. A video type work 
Station (terminal) such as the TD820 and 
T0830 terminal devices. 


WAITING SCHEDULE: Contains the names and runcstime attributes 
of jobs that are waiting to be placed into 
the Active Schedule. 


ZIP: A method by which a program such as SYCOMe 
communicates with. the MCP for certain 
specific MCP functions. 
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ACU = Auto Call Unit 
AP = Application Program 


ASCII = American Standard Code for Information 
Interchange 


BCC = Block Check Character 

BOJ - Beginning Of Joo 

bpi = Bits Per Second 

D/S - Data Set 

DOD - Direct Distance Dialing 

dp~id -~- Disk Pack IDentifier 

E0J - End Of Job 

1/0 7 Input/Output 

tsn = Logical Station Number 

MCP = Master Control epee 

NC = Network Controller 

NDL - Network Definition Language 
NIF = Ne twork Information File 

RJE = Remote Job Entry 

RSN - Relative Station Number 
SMCS - Supervisory Message Control System 
$0G - Software Operational Guide 
SPO - Supervisory Printer Output 

SYCOM - Systems Communications Module 

udi = Unit Device Identifier 


VOT - Video Disptay Terminal 


— ee ee ee ee eee ee a ee ee ete eee ee eee ee ee ee eee eee eee eee ee ee eee et ee we 
Ce ee en en ne ee ee eee ee eS ee 
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READ Command > © © #@© © #© @ © @ © © © © © © © ww» #8 @ III ¢ 
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